tech-leads-club-agent-skills

📖 Table of Contents

• ✨ What are Skills?
• 🛡️ Security & Trust
• 🤖 Supported Agents
• 🌟 Featured Skills
• 🚀 Quick Start
• ⚡ How It Works
• 🔌 MCP Server
• 🤝 Contributing
• 🛡️ Content & Authorship
• 📄 License and Attribution

✨ 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

🌟 Featured Skills

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.

🚀 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