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…

这是做什么的?Agent Skills 是一个经过精选和安全审查的 AI 编程智能体技能注册库——你可以通过 CLI 或 MCP 服务器把其中的技能安装到 Claude Code、Cursor、Antigravity、GitHub Copilot 这类工具里。
那这里的“技能”到底是什么?技能是打包好的指令和资源,用来扩展 AI 智能体能做的事——就像插件一样,教你的助手掌握新的工作流程、模式和专业知识。
怎么把技能装进我的智能体?运行 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 静态分析、内容哈希加 lockfile、symlink 防护,以及发布前的 Snyk Agent Scan 扫描。
每次使用都要联网吗?只有首次下载需要联网:CLI 会从 CDN 按需获取目录(约 45KB)和技能,然后把所有内容缓存到 ~/.cache/agent-skills/,之后就能离线使用了。
在工作中使用这些技能,授权上有什么要注意的吗?CLI 采用 MIT 许可证,维护者自己编写的技能采用 CC-BY-4.0,但第三方技能沿用其原始许可证——而且只要你使用这个目录,就必须注明出处 Tech Leads Club。
目录里到底有哪些类型的技能?涵盖开发、云服务、自动化、设计和安全——例如用于分阶段功能规划的 tlc-spec-driven、提供 AWS 架构指导的 aws-advisor、浏览器自动化的 playwright-skill、设计转代码的 figma,以及漏洞审查用的 security-best-practices。
MCP 服务器是干什么的——光有 CLI 不够吗?它是可选的:@tech-leads-club/agent-skills-mcp 把同一份目录直接暴露给任何兼容 MCP 的智能体,让智能体自己去列出、模糊搜索、读取和获取技能文件(listskills、searchskills、readskill、fetchskillfiles),而不用你通过 CLI 手动安装。
Size
25.1 MB
Stars
7.1K
Age
8mo
Commits · 90 Days