Skip to content

Battle-tested skill library for AI agents. Save 98% of API costs with ready-to-use code for crypto, PDFs, search, web scraping & more. No trial-and-error, no expensive APIs.

Notifications You must be signed in to change notification settings

besoeasy/open-skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open Skills

Teach your AI Agent Must-Have Skills β€” Save 98% of API Calls

Stop wasting tokens on trial-and-error.

Give your AI agent battle-tested, ready-to-use skills that work the first time β€” cut token usage by 95–98%, lower model costs, and make smaller models reliable.

MAIN INSTALLATION: USE THE WEBSITE QUICK START

Use Open Skills Now

MIT License Skills Contributions Telegram

Battle-tested, copy-paste execution playbooks for AI agents.

Two ways to win:

🏠 Go 100% free β€” Ollama + Llama/Mistral/Qwen + Open Skills = cloud-level practical task execution at $0

πŸ’° Keep cloud quality, slash cloud cost β€” GPT-4/Claude/Gemini + Open Skills = ~$0.003–$0.005/task instead of ~$0.15–$0.25


Quick Links

Why This Matters

The Problem: AI agents are expensive and cloud-dependent:

  • Cloud models (GPT-4, Claude, Gemini): Often spend 10–30+ calls discovering and debugging each task β†’ ~$0.15–$0.25 per simple task
  • Local models (Llama, Mistral, Qwen): Often know the goal but fail at API/tool details without guidance
  • Both burn through tokens on trial-and-error, searching documentation, and debugging

The Solution: Pre-written, tested skills that work with ANY AI model:

  • βœ… Working code examples (Node.js, Bash) β€” no debugging needed
  • βœ… Privacy-first tools β€” free public APIs, no API keys required for most skills
  • βœ… Agent-optimized prompts β€” structured for direct consumption by LLMs
  • βœ… Real-world tested β€” production-ready patterns, not theoretical examples

The New Approach: Separate reasoning from execution knowledge.

  • Model handles intent and orchestration
  • Open Skills provides tested implementation steps (commands, API patterns, parsing logic)
  • Outcome: faster execution, lower token usage, and higher reliability across both cloud and local models

The Game-Changer: πŸš€ Make local models as capable as cloud models

Instead of paying models to figure everything out from scratch, give them proven execution playbooks:

  • Llama 3.1 / Mistral / Qwen (free, local) + Open Skills β†’ performs like GPT-4/Claude for practical tasks
  • Result: $0 cost, 100% self-hostable, complete privacy

The Impact:

  • πŸ’° 95–98% cloud cost reduction β€” Cloud models drop from ~$0.15–$0.25 to ~$0.003–$0.005 per task with skills
  • 🏠 $0 local operation β€” Local models + skills run practical tasks without cloud spend
  • 🏠 100% self-hostable β€” Run Ollama + Open Skills entirely offline
  • πŸ”’ Complete privacy β€” No data leaves your machine
  • ⚑ 10-50x faster execution β€” No trial-and-error loops
  • 🎯 Higher success rate β€” Proven patterns that work reliably
  • πŸ€– Automated contributions β€” Agents can auto-fork, commit, and PR new skills via GitHub CLI
  • 🧠 Self-improving ecosystem β€” Community skills flow back into the repository automatically
  • πŸ† Public credit β€” Contributors get GitHub commit history and recognition
  • πŸ” Zero search API costs β€” Use free SearXNG instances instead of paying for Brave Search ($5/1000), Google Search API, or Bing API

Real-World Example

Without open-skills (Cloud models like GPT-4/Claude):

User: "Check the balance of this Bitcoin address: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"

Cloud AI Agent β†’ Searches for "bitcoin balance API"
                β†’ Tries blockchain.com (wrong endpoint)
                β†’ Tries blockchain.info (wrong format)
                β†’ Debugs response parsing
                β†’ Realizes satoshis need conversion
                β†’ Finally works after 15-20 API calls

Result: ❌ 2-3 minutes, 50,000+ tokens, $0.15-$0.25 cost

Without open-skills (Local models like Llama/Mistral):

User: "Check the balance of this Bitcoin address: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"

Local AI (Llama/Mistral) β†’ Tries to search for API documentation
                         β†’ Gets confused about endpoints
                         β†’ Generates incorrect curl command
                         β†’ Unable to parse response correctly
                         β†’ Gives up or returns error

Result: ❌ Task fails, user frustrated

With open-skills (ANY MODEL - GPT-4, Claude, Llama, Mistral, Gemini):

User: "Check the balance of this Bitcoin address: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"

Any AI Agent β†’ Finds check-crypto-address-balance.md
             β†’ Uses working example: curl blockchain.info/q/addressbalance/[address]
             β†’ Converts satoshis to BTC (Γ· 1e8)
             β†’ Returns result

Result: βœ… 10 seconds, ~1,000 tokens, works first time
        βœ… Cloud models: $0.003-$0.005 (was $0.15-$0.25) β€” 95%+ savings
        βœ… Local models: $0.00 (free) β€” task actually succeeds

Key insight: Open Skills doesn't just make expensive models cheaper β€” it helps low-powered and free models run tasks reliably with less hallucination.


Example 2: Web Search (API Cost Elimination)

Without open-skills:

User: "Search for recent AI agent news"

Agent β†’ Uses Google Custom Search API ($5/1000 queries)
      β†’ Or Brave Search API ($5/1000 queries)
      β†’ Bing Search API ($3-7/1000 queries)
      β†’ Monthly cost: $50-100+ for 10k searches

Result: ❌ Expensive, requires API keys, tracked searches

With open-skills:

User: "Search for recent AI agent news"

Agent β†’ Uses SearXNG skill (learns from [skills/web-search-api/SKILL.md](skills/web-search-api/SKILL.md))
      β†’ Connects to free SearXNG instance (searx.be)
      β†’ Gets results from 70+ search engines
      β†’ No API key, no rate limits, no tracking

Result: βœ… $0 cost, unlimited queries, privacy-respecting

Savings: $360-$840/year for typical usage, $3,000-$8,000/year for high-volume agents


Example 3: Trading Indicators (Quant Analysis in Seconds)

Without open-skills:

User: "Calculate RSI, MACD, and top indicators from this OHLCV dataset"

Agent β†’ Searches for indicator formulas one by one
      β†’ Implements RSI, then debugs MACD math
      β†’ Repeats for Bollinger, Stochastic, ATR, ADX, etc.
      β†’ Fixes column mapping/warmup NaN issues
      β†’ Ends up with inconsistent outputs after many iterations

Result: ❌ Slow, error-prone, heavy token/API usage

With open-skills:

User: "Calculate RSI, MACD, and top indicators from this OHLCV dataset"

Agent β†’ Finds trading-indicators-from-price-data.md
      β†’ Runs the ready Python workflow with pandas + pandas-ta
      β†’ Computes 20 indicators (RSI, MACD, SMA/EMA, BB, Stoch, ATR, ADX, CCI, OBV, MFI, ROC)
      β†’ Returns clean, structured output immediately

Result: βœ… Fast, consistent, production-ready calculations

Savings: Massive reduction in trial-and-error, faster indicator pipelines, and more reliable strategy signals


Example 4: Hosted Report Website (Tailwind + Originless)

Without open-skills:

User: "Create a beautiful white-themed report website from this content and host it instantly"

Agent β†’ Experiments with random HTML/CSS templates
      β†’ Tries multiple hosting providers and auth flows
      β†’ Debugs upload endpoints and response formats
      β†’ Rewrites password logic several times
      β†’ Finally ships a fragile page after many retries

Result: ❌ Slow delivery, inconsistent styling, avoidable token/API waste

With open-skills:

User: "Create a beautiful white-themed report website from this content and host it instantly"

Agent β†’ Finds generate-report-originless-site.md
      β†’ Generates index.html with Tailwind CDN + subtle animations
      β†’ Applies clean white-background report layout
      β†’ Uploads to Originless (local/public endpoint)
      β†’ Returns hosted URL/CID immediately
      β†’ If requested, adds client-side password unlock for encrypted content

Result: βœ… Fast static site generation, instant decentralized hosting, predictable output

Savings: Fewer retries, faster publish time, and consistent website quality with account-free hosting

Cost Savings Calculator

For Cloud Models (Make them 98% cheaper)

Typical AI agent task without pre-built skills: 20-50 API calls (trial and error)
Same task with open-skills: 1-3 API calls (direct execution)

Model Cost per 1M tokens (input) Without open-skills With open-skills Savings per task
GPT-4 $5.00 $0.25 (50k tokens) $0.005 (1k tokens) $0.245 (98%)
Claude Sonnet 3.5 $3.00 $0.15 (50k tokens) $0.003 (1k tokens) $0.147 (98%)
GPT-3.5 Turbo $0.50 $0.025 (50k tokens) $0.0005 (1k tokens) $0.0245 (98%)

Over 100 tasks/month:

  • GPT-4: Save ~$24.50/month
  • Claude: Save ~$14.70/month
  • For teams running 1,000+ agent tasks: Save $240-$1,470/month

For Local Models (Make them actually work)

The Real Game-Changer: Open Skills makes local models competitive with GPT-4 for practical tasks.

Model Stack Cost Success Rate Speed Privacy
Cloud models without skills $0.15-$0.25/task 85-95% 2-3 min ❌ Cloud
Cloud models with skills $0.003-$0.005/task 98% 10 sec ❌ Cloud
Local models without skills $0 30-50% Varies βœ… Local
πŸš€ Local models + Open Skills $0 95%+ 10 sec βœ… Local

The 100% Free, Self-Hostable AI Agent Stack:

# Install Ollama (free, local)
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.1:8b

# Clone Open Skills (free, open-source)
git clone https://github.com/besoeasy/open-skills ~/open-skills

# Result: GPT-4-level task execution at $0 cost
# - No API keys needed
# - No cloud dependency
# - Complete privacy
# - 100% self-hostable

Monthly cost comparison:

  • Cloud models (GPT-4/Claude) without skills: $150-$1,470/month (1,000 tasks)
  • Cloud models with skills: $3-$15/month (95%+ savings)
  • Local models (Llama/Mistral) + Open Skills: $0/month (100% free, actually works)

Plus: Eliminate search API costs entirely by using free SearXNG instances instead of:

  • Google Custom Search API ($5/1000 queries) β†’ $0 with SearXNG
  • Brave Search API ($5/1000 queries) β†’ $0 with SearXNG
  • Bing Search API ($3-7/1000 queries) β†’ $0 with SearXNG

Total potential savings: $600-$2,300/month for active AI agents
Or go 100% free with local models + Open Skills: $0/month forever

Perfect For

  • 🏠 Self-hosted AI enthusiasts β€” Run Llama/Mistral with Ollama + Open Skills for GPT-4-level capabilities at $0 cost
  • πŸ€– Autonomous AI agents β€” Give your agent production-ready capabilities out of the box
  • πŸ’Ό Business automation β€” Crypto monitoring, document processing, web scraping, notifications
  • πŸ” Eliminating API costs β€” Replace expensive search, translation, geocoding, and weather APIs with free alternatives
  • πŸ› οΈ Developer tools β€” Integrate with OpenCode.ai, Claude Desktop, Ollama, custom MCP servers
  • πŸ“š AI learning β€” Study working examples instead of guessing API patterns
  • πŸ” Privacy-conscious projects β€” All skills use open-source tools and public APIs, run entirely offline
  • πŸ’° Cost-sensitive teams β€” Reduce AI agent costs by 98% or go completely free with local models

Philosophy

Why we built this:

AI agents are incredibly powerful, but there's a massive gap:

  • Expensive cloud models (GPT-4, Claude, Gemini): Smart enough to figure things out, but cost $0.15-$0.25+ per task
  • Free local models (Llama, Mistral, Qwen): Can't figure things out reliably, so they fail or give up

Open Skills bridges this gap by providing the "figuring out" part:

  • Instead of making models search, experiment, and debug β†’ Give them working code
  • Instead of requiring high intelligence β†’ Provide pre-tested patterns
  • Result: Cheap models execute like expensive models

Our approach:

  • βœ… Tested code, not theory β€” Every example is production-ready
  • βœ… Privacy-first β€” Open-source tools, minimal tracking, no vendor lock-in
  • βœ… Agent-optimized β€” Written for LLM consumption (clear structure, copy-paste ready)
  • βœ… Free to use β€” MIT licensed, no API keys required for core functionality
  • βœ… Model-agnostic β€” Works with GPT-4, Claude, Gemini, Llama, Mistral, Qwen, any LLM

The result: AI agents that are smarter, faster, and cheaper to run β€” or completely free with local models.

About

Battle-tested skill library for AI agents. Save 98% of API costs with ready-to-use code for crypto, PDFs, search, web scraping & more. No trial-and-error, no expensive APIs.

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages