awesome-claude-skills README

The project's README from github.com/travisvn/awesome-claude-skills. As one markdown file: README.md.

Awesome Claude Skills

Awesome Claude Skills

Awesome Last Updated PRs Welcome

A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows

Claude Skills teach Claude how to perform tasks in a repeatable way

They are specialized folders containing instructions, scripts, and resources that Claude dynamically discovers and loads when relevant to tasks.

How Skills Work

Skills employ a progressive disclosure architecture for efficiency:

  1. Metadata loading (~100 tokens): Claude scans available Skills to identify relevant matches
  2. Full instructions (<5k tokens): Load when Claude determines the Skill applies
  3. Bundled resources: Files and executable code load only as needed

This design allows multiple Skills to remain available without overwhelming Claude's context window.

🚀 Getting Started

Claude.ai Web Interface

  1. Go to Settings > Capabilities
  2. Enable Skills toggle
  3. Browse available skills or upload custom skills
  4. For Team/Enterprise: Admin must enable Skills organization-wide first

Claude Code CLI

# Install skills from marketplace
/plugin marketplace add anthropics/skills

# Or install from local directory
/plugin add /path/to/skill-directory

Claude API

Skills are accessible via the /v1/skills API endpoint. See the Skills API documentation for detailed integration examples.

import anthropic

client = anthropic.Client(api_key="your-api-key")
# See API docs for full implementation details

🎯 Official Skills

Document Skills

Skills for working with complex file formats:

Design & Creative

Development

Communication

Skill Creation

🌟 Community Skills

[!Warning] Skills can execute arbitrary code in Claude's environment.

See Security & Best Practices for more information

Collections & Libraries

Individual Skills

These will be broken down into categories once there are enough community skills available to list

Skill Description
ios-simulator-skill iOS app building, navigation, and testing through automation
ffuf-web-fuzzing Expert guidance for ffuf web fuzzing during penetration testing, including authenticated fuzzing with raw requests, auto-calibration, and result analysis
playwright-skill General-purpose browser automation using Playwright
claude-d3js-skill Visualizations in d3.js
claude-scientific-skills Comprehensive collection of ready-to-use scientific skills, including working with specialized scientific libraries and databases
web-asset-generator Generates web assets like favicons, app icons, and social media images
loki-mode Multi-agent autonomous startup system - orchestrates 37 AI agents across 6 swarms to build, deploy, and operate a complete startup from PRD to revenue
Trail of Bits Security Skills Security skills for static analysis with CodeQL/Semgrep, variant analysis, code auditing, and vulnerability detection
frontend-slides Create animation-rich HTML presentations — from scratch or by converting PowerPoint files
Expo Skills Official skills by the Expo team for developing Expo apps
shadcn/ui Give Claude Code context on shadcn components as well as pattern enforcement
get-shit-done Lightweight meta-prompting, context engineering, and spec-driven development system for Claude Code by TÂCHES

More community skills coming soon! Submit a PR to add your skill.

Tools

✏️ Creating Your First Skill

Step-by-Step Guide

The easiest way to create a skill is to use the built-in skill-creator:

  1. Enable the skill-creator skill in Claude
  2. Ask Claude: "Use the skill-creator to help me build a skill for [your task]"
  3. Answer the interactive questions about your workflow
  4. Claude generates the complete skill structure for you

Method 2: Manual Creation

  1. Create folder structure:

    my-skill/
    ├── SKILL.md          # Main skill file with frontmatter
    ├── scripts/          # Optional executable scripts
    │   └── helper.py
    └── resources/        # Optional supporting files
        └── template.json
    
  2. Create SKILL.md with frontmatter:

    ---
    name: my-skill
    description: Brief description for skill discovery (keep concise)
    ---
    
    # Detailed Instructions
    
    Claude will read these instructions when the skill is activated.
    
    ## Usage
    Explain how to use this skill...
    
    ## Examples
    Provide clear examples...
    
  3. Add executable scripts (optional):

    • Python, JavaScript, or other scripts Claude can execute
    • Reference them in your SKILL.md instructions
  4. Test locally:

    • Install the skill in Claude Code or Claude Desktop
    • Test with relevant tasks
    • Iterate and refine
  5. Share:

    • Publish to GitHub
    • Submit to this awesome list via PR
    • Share with your team via git repos or internal distribution

Best Practices

  • Keep descriptions concise - The frontmatter description is used for skill discovery
  • Use clear, actionable instructions - Write instructions as if for a human collaborator
  • Include examples - Show specific examples in your SKILL.md
  • Version your skills - Use git tags for version management
  • Document dependencies - List any prerequisites or required packages
  • Test thoroughly - Verify your skill works across different scenarios

📚 Official Documentation & Resources

Getting Started

Documentation

Repositories & Examples

📅 Recent Updates

November 2025

October 2025

💡 Skills vs Other Approaches

Quick Reference: When to Use What

Tool Best For
Skills Reusable procedural knowledge across conversations
Prompts One-time instructions and immediate context
Projects Persistent background knowledge within workspaces
Subagents Independent task execution with specific permissions
MCP Connecting Claude to external data sources

Use Skills when: Capabilities should be accessible to any Claude instance. They're portable expertise.

Use Subagents when: You need self-contained agents designed for specific purposes with independent workflows and restricted tool access.

Combined approach: Subagents can leverage Skills for specialized expertise, merging independence with portable knowledge.

Key insight: If you find yourself typing the same prompt repeatedly across multiple conversations, it's time to create a Skill.

Skills vs MCP (Model Context Protocol)

Feature Skills MCP
Purpose Task-specific expertise and workflows External data/API integration
Portability Same format everywhere (Claude.ai, Code, API) Requires server configuration
Code Execution Can include executable scripts Provides tools/resources
Token Efficiency 30-50 tokens until loaded Varies by implementation
Best For Repeatable tasks, document workflows Database access, API integrations

Use Together: Skills can create MCP servers! The mcp-builder skill helps build high-quality MCP integrations.

Skills vs System Prompts

Feature Skills System Prompts
Structure Folder with YAML frontmatter, instructions, scripts Plain text instructions
Reusability Version-controlled, shareable, composable Copy-paste, conversation-specific
Loading On-demand (only when relevant) Always in context
Maintenance Centralized updates Manual updates per conversation
Composability Multiple skills stack automatically Manual combination

📖 Tutorials & Guides

Written Tutorials

Video Tutorials

Video tutorials coming soon! Have a good video about Claude Skills? Submit a PR!

Example topics we'd love to see
  • Getting started with Claude Skills
  • Building your first custom skill
  • Skills vs MCP comparison
  • Enterprise deployment strategies

📰 Articles & Blog Posts

🔒 Security & Best Practices

⚠️ Important: Skills can execute arbitrary code in Claude's environment. Only install skills from trusted sources.

Security Guidelines & Best Practices

Vetting Skills

  • Only install skills from trusted sources
  • Review SKILL.md and all scripts before enabling a skill
  • Be cautious of skills that request sensitive data access
  • Audit carefully before deploying to production or enterprise environments

Security Concerns

  • Malicious skills may introduce vulnerabilities or enable data exfiltration
  • Prompt injection attacks could be amplified through compromised skills
  • Sandboxing limitations - Understand the security model before enterprise deployment
  • Security research: Weaponizing Claude Code Skills - Analysis of potential security risks

Best Practices

  • Version control - Track all skills in git with proper version tags
  • Code review - Peer review custom skills before team distribution
  • Least privilege - Only grant necessary permissions and access
  • Regular audits - Periodically review installed skills
  • Documentation - Maintain clear documentation for custom skills
  • Testing - Thoroughly test skills in non-production environments first

Enterprise Considerations

  • As of October 2025, Claude.ai does not support centralized admin management for custom skills
  • Use version control and internal repositories for team skill distribution
  • Establish clear policies for skill vetting and approval
  • Monitor skill usage and performance

🛠️ Troubleshooting

Known Issues & Common Problems

Known Issues

  • Linux path bug (Oct 18, 2025): Agent SDK uses hardcoded macOS paths instead of environment home directory

    • Issue #268
    • Workaround: Manually specify skill paths
  • Enterprise distribution: No centralized admin management yet for custom skills on claude.ai

    • Use git repositories for team distribution
    • API integration provides more control

Common Problems

Skills not appearing in Claude

  • Check Settings > Capabilities to ensure Skills are enabled
  • For Team/Enterprise: Verify admin has enabled Skills organization-wide
  • Restart Claude after installing new skills

Skills not loading/activating

  • Verify SKILL.md has proper YAML frontmatter format
  • Check that name and description fields are present
  • Ensure file structure matches expected format

Permission errors

  • Review admin settings for Team/Enterprise accounts
  • Check file permissions in skill directories
  • Verify API key has appropriate permissions

Skill execution failures

  • Check script dependencies are installed
  • Review error logs for specific issues
  • Test scripts independently outside of Claude

Getting Help

❓ FAQ

Common Questions

Q: How much do skills impact token usage?

A: Skills are highly efficient thanks to progressive disclosure. Each skill uses only ~100 tokens during metadata scanning to determine relevance. When activated, the full skill content loads at <5k tokens. Bundled resources only load as needed.

Q: What's the difference between Claude Skills and Agent Skills?

A: They are the same thing.

Q: Can I share skills with my team?

A: Yes! Skills can be shared via:

  • Git repositories (recommended)
  • Internal file sharing
  • Claude API for programmatic distribution
  • Enterprise-

awesome-claude-skills (travisvn/awesome-claude-skills)

Searching Database…

Что это такое?Подобранный список (awesome-list) навыков Claude (Claude Skills), ресурсов и инструментов для настройки рабочих процессов Claude AI, особенно Claude Code.
Это рабочий инструмент или просто список ссылок?Это исключительно подобранный индекс/README: он ссылается на официальные и сообщественные навыки, документацию, руководства и статьи, но сам не содержит никакого кода.
Как устроен список?Он разделён на официальные навыки (Document, Design & Creative, Development, Communication, Skill Creation), навыки от сообщества (подборки и отдельные навыки), официальную документацию и ресурсы, последние обновления, сравнения с другими подходами, руководства и раздел о безопасности.
Что именно такое «навык» (Skill) и как Claude его использует?Навык — это папка с инструкциями, скриптами и ресурсами, которые Claude динамически находит и загружает по принципу постепенного раскрытия: сначала читает лёгкие метаданные (около 100 токенов), и только потом загружает полные инструкции.
Безопасно ли устанавливать любой навык из этого списка?Нет: навыки могут выполнять произвольный код в среде Claude, поэтому устанавливать стоит только навыки из надёжных источников и проверять скрипты перед включением.
Для кого предназначен этот список?Для разработчиков и команд, которые используют Claude.ai, Claude Code или Claude API и хотят находить или создавать многоразовые, повторяемые рабочие процессы (навыки) для Claude.
Как создать свой навык?Воспользуйтесь встроенным навыком skill-creator для интерактивного создания через вопросы и ответы или вручную создайте папку с файлом SKILL.md (с заголовком frontmatter) и, по желанию, исполняемыми скриптами, затем протестируйте её локально в Claude Code или Claude Desktop.
Чем навыки отличаются от MCP или системных промптов?Навыки — это переносимая экспертиза для задач, которая загружается по запросу и может включать исполняемые скрипты (один и тот же формат в Claude.ai, Code и API). В отличие от MCP, который подключает внешние данные и API через серверы, и от системных промптов, которые всегда находятся в контексте как простой текст без версионирования и возможности комбинирования.
Какие примеры официальных навыков входят в список?Официальные навыки включают docx, pdf, pptx и xlsx для работы с документами, а также algorithmic-art, canvas-design, frontend-design, web-artifacts-builder, mcp-builder, webapp-testing, brand-guidelines, internal-comms и skill-creator.
Проверяются ли навыки от сообщества перед добавлением в список?README не описывает формальной процедуры проверки, кроме предупреждения о безопасности; в нём прямо сказано, что устанавливать навыки стоит только из надёжных источников и самостоятельно проверять SKILL.md и скрипты перед включением.
Creator
travisvn
Size
<0.1 MB
Stars
15.5K
Updated
CommitApr 28
Age
1y
Commits · 90 Days