agent-skills README

The project's README from github.com/tech-leads-club/agent-skills. As one markdown file: README.md.

Tech Leads Club

npm version total downloads monthly downloads license build status

node version typescript nx cloud semantic-release

github stars contributors last commit ai powered

🧠 Agent Skills

The secure, validated skill registry for professional AI coding agents

In an ecosystem where over 13% of marketplace skills contain critical vulnerabilities, Agent Skills stands apart as a hardened library of verified, tested, and safe capabilities. Extend Antigravity, Claude Code, Cursor, and more with absolute confidence.

https://tech-leads-club.github.io/agent-skills/

📖 Table of Contents

✨ What are Skills?

Skills are packaged instructions and resources that extend AI agent capabilities. Think of them as plugins for your AI assistant — they teach your agent new workflows, patterns, and specialized knowledge.

packages/skills-catalog/skills/
  (category-name)/
    skill/
      SKILL.md          ← Main instructions
      templates/        ← File templates
      references/       ← On-demand documentation

🛡️ Security & Trust

Your environment's safety is our top priority. Unlike open marketplaces where 13.4% of skills contain critical issues, agent-skills is a managed, hardened library: 100% open source (no binaries), static analysis in CI/CD, immutable integrity via lockfiles and content hashing, and human-curated prompts. The CLI uses defense-in-depth (sanitization, path isolation, symlink guards, atomic lockfile, audit trail); every skill is scanned with Snyk Agent Scan (formerly mcp-scan) before publishing.

→ Full threat model, implementation details, and vulnerability reporting: SECURITY.md

🤖 Supported Agents

Install skills to any of these AI coding agents:


Tier 1 (Popular) Tier 2 (Rising) Tier 3 (Enterprise)
Claude Code Aider Amazon Q
Cline Antigravity Augment
Cursor Gemini CLI Droid (Factory.ai)
GitHub Copilot Kilo Code OpenCode
Windsurf Kiro Sourcegraph Cody
OpenAI Codex Tabnine
Roo Code
TRAE

Missing your favorite agent? Open an issue and we'll add support!

A glimpse of what's available in our growing catalog:

Skill Category Description
tlc-spec-driven Development Project and feature planning with 4 phases: Specify → Design → Tasks → Implement. Creates atomic tasks with verification criteria and maintains persistent memory across sessions.
aws-advisor Cloud Expert AWS Cloud Advisor for architecture design, security review, and implementation guidance. Leverages AWS MCP tools for documentation-backed answers.
playwright-skill Automation Complete browser automation with Playwright. Test pages, fill forms, take screenshots, validate UX, and automate any browser task.
figma Design Fetch design context from Figma and translate nodes into production code. Design-to-code implementation with MCP integration.
security-best-practices Security Language and framework-specific security reviews. Detect vulnerabilities, generate reports, and suggest secure-by-default fixes.

→ Browse all skills

🚀 Quick Start

Install Skills in Your Project

npx @tech-leads-club/agent-skills

This launches an interactive wizard:

  1. Choose Action — "Install skills" or "Update installed skills"
  2. Browse & Select — Filter by category or search
  3. Choose agents — Pick target agents (Cursor, Claude Code, etc.)
  4. Installation method — Copy (recommended) or Symlink
  5. Scope — Global (user home) or Local (project only)

Each step shows a ← Back option to return and revise your choices.

CLI Options

Note: You can use either npx @tech-leads-club/agent-skills or install globally and use agent-skills directly.

# Interactive mode (default)
npx @tech-leads-club/agent-skills
# or: agent-skills (if installed globally)

# List available skills
agent-skills list
agent-skills ls        # Alias

# Install one skill
agent-skills install -s tlc-spec-driven

# Install multiple skills at once
agent-skills install -s aws-advisor coding-guidelines docs-writer

# Install to specific agents
agent-skills install -s my-skill -a cursor claude-code

# Install multiple skills to multiple agents
agent-skills install -s aws-advisor nx-workspace -a cursor windsurf cline

# Install globally (to ~/.gemini, ~/.claude, etc.)
agent-skills install -s my-skill -g

# Use symlink instead of copy
agent-skills install -s my-skill --symlink

# Force re-download (bypass cache)
agent-skills install -s my-skill --force

# Update a specific skill
agent-skills update -s my-skill

# Update all installed skills
agent-skills update

# Remove one skill
agent-skills remove -s my-skill

# Remove multiple skills at once
agent-skills remove -s skill1 skill2 skill3
agent-skills rm -s my-skill    # Alias

# Remove from specific agents
agent-skills remove -s my-skill -a cursor windsurf

# Force removal (bypass lockfile check)
agent-skills remove -s my-skill --force

# Manage cache
agent-skills cache --clear           # Clear all cache
agent-skills cache --clear-registry  # Clear only registry
agent-skills cache --path            # Show cache location

# View audit log
agent-skills audit                   # Show recent operations
agent-skills audit -n 20             # Show last 20 entries
agent-skills audit --path            # Show audit log location

# Show contributors and credits
agent-skills credits

# Show help
agent-skills --help

Global Installation (Optional)

npm install -g @tech-leads-club/agent-skills
agent-skills  # Use 'agent-skills' instead of 'npx @tech-leads-club/agent-skills'

⚡ How It Works

The CLI fetches skills on-demand from our CDN:

  1. Browse — The CLI fetches the skills catalog (~45KB)
  2. Select — You choose the skills you need
  3. Download — Selected skills are downloaded and cached locally
  4. Install — Skills are installed to your agent's configuration

Caching

Downloaded skills are cached in ~/.cache/agent-skills/ for offline use.

# Clear the cache
rm -rf ~/.cache/agent-skills

🔌 MCP Server

@tech-leads-club/agent-skills-mcp is an MCP server that exposes the skills catalog directly to AI agents via progressive disclosure — search first, then fetch only what's needed.

Tool Purpose
list_skills Browse all skills by category
search_skills Find skills by intent (fuzzy search)
read_skill Load a skill's main instructions
fetch_skill_files Fetch specific reference files

list_skills should be called only when the user explicitly asks to browse/list the catalog.

Quick install (works with any MCP-compatible client):

{
  "mcpServers": {
    "agent-skills": {
      "command": "npx",
      "args": ["-y", "@tech-leads-club/agent-skills-mcp"]
    }
  }
}

→ Full setup for all clients (Cursor, Claude Code, VS Code, etc.), caching, and error reference: packages/mcp/README.md

🤝 Contributing

We welcome contributions! Please see our CONTRIBUTING.md file for detailed guidelines on how to set up your local environment, create new skills, contribute to the marketplace, and follow our release processes.

🛡️ Content & Authorship

This repository is a collection of curated skills intended to benefit the community. We deeply respect the intellectual property and wishes of all creators.

If you are the author of any content included here and would like it removed or updated, please open an issue or contact the maintainers.

📄 License and Attribution

If you use our skills catalog, you must provide attribution to Tech Leads Club, regardless of how it is used.

⭐ Star History

Star History Chart

Built with ❤️ by the Tech Leads Club community

agent-skills (tech-leads-club/agent-skills)

Searching Database…

7.1K ·GitHub
Agent-skills
Что это такое?Agent Skills — это тщательно отобранный и проверенный с точки зрения безопасности каталог навыков для ИИ-агентов, которые пишут код. Навыки из него устанавливаются через CLI или MCP-сервер в такие инструменты, как Claude Code, Cursor, Antigravity и GitHub Copilot.
А что здесь вообще называется «навыком»?Навыки — это упакованные инструкции и материалы, которые расширяют возможности ИИ-агента. Это как плагины, которые учат вашего помощника новым рабочим процессам, паттернам и специальным знаниям.
Как добавить навыки в своего агента?Запустите npx @tech-leads-club/agent-skills (нужен Node 24+): интерактивный мастер проведёт вас через выбор навыков, выбор целевых агентов, способа установки (рекомендуется Copy, есть и Symlink) и области действия (глобально или на отдельный проект).
С какими агентами для кодинга это работает?18 агентов в трёх уровнях: Claude Code, Cline, Cursor, GitHub Copilot и Windsurf; затем Aider, Antigravity, Gemini CLI, OpenAI Codex и Roo Code; плюс корпоративные варианты вроде Amazon Q, OpenCode, Sourcegraph Cody и Tabnine.
А это вообще безопасно — ставить навыки из каталога?Именно на этом строится весь проект: в README указано, что 13,4% навыков в открытых маркетплейсах имеют критические уязвимости, и в ответ предлагается: 100% навыков с открытым кодом (без бинарных файлов), статический анализ в CI, хеширование содержимого с lock-файлами, защита от подмены через symlink и проверка Snyk Agent Scan перед публикацией.
Нужно ли быть онлайн каждый раз, когда я им пользуюсь?Только при первой загрузке: CLI скачивает каталог (около 45KB) и нужные навыки с CDN, а затем кеширует всё в ~/.cache/agent-skills/ для работы офлайн.
Есть ли подводные камни с лицензиями, если использовать эти навыки в работе?CLI распространяется по лицензии MIT, навыки, написанные мейнтейнерами, — по CC-BY-4.0, но сторонние навыки сохраняют свои исходные лицензии. Кроме того, при любом использовании каталога нужно указывать авторство Tech Leads Club.
Какие навыки вообще есть в каталоге?Он охватывает разработку, облако, автоматизацию, дизайн и безопасность. Например: tlc-spec-driven для поэтапного планирования фич, aws-advisor для рекомендаций по архитектуре AWS, playwright-skill для автоматизации браузера, figma для превращения дизайна в код и security-best-practices для проверки на уязвимости.
Зачем тогда MCP-сервер — разве CLI недостаточно?Он необязателен: @tech-leads-club/agent-skills-mcp открывает тот же каталог напрямую любому агенту с поддержкой MCP, чтобы агент сам мог выводить список навыков, искать по нечёткому совпадению, читать и загружать файлы навыков (listskills, searchskills, readskill, fetchskillfiles) — вместо того чтобы вы устанавливали их через CLI.
What are similar projects?superpowers-zh, codegraph, testsprite-cli, context-mode, billion-context, brag, agentmemory, rea
Which topics is it in?windsurf, marketplace, copilot, antigravity, gemini-cli, static-analysis, opencode, coding-agents, ci, cursor, skills, mcp-server
Creator
tech-leads-club
Size
25.1 MB
Stars
7.1K
Updated
CommitOct 16Releaseskills-catalog-v0.17.13Oct 16
Age
8mo
Commits · 90 Days