Generated: 2026-04-08 Repository: https://github.com/secondsky/claude-skills
Total Size: 22.7MB | Files: 3,008
Top File Types: .md (1,589), .ts (369), .json (244), .sh (148), .html (131)
This document provides a comprehensive overview of the claude-skills repository structure, generated using codemap.
claude-skills/
├── .claude-plugin/ # Plugin marketplace configuration
├── .githooks/ # Git hooks (pre-commit, pre-push)
├── .github/ # GitHub CI workflows & issue templates
├── commands/ # Slash commands for Claude Code CLI
├── docs/ # Documentation (5 subdirectories)
├── plugins/ # 170 plugin directories containing 211 skills
├── schemas/ # JSON schema validation files
├── scripts/ # Automation & utility scripts
├── templates/ # Skill creation templates
└── *.md # Root documentation files
Plugin marketplace configuration for Claude Code.
.claude-plugin/
└── marketplace.json # Main marketplace manifest (84KB)
Purpose: Defines 170 plugins containing 211 skills for Claude Code's plugin marketplace.
Custom Git hooks for repository quality enforcement.
.githooks/
├── README.md # Git hooks documentation
├── pre-commit # Pre-commit validation
└── pre-push # Pre-push checks
GitHub configuration for CI/CD and issue management.
.github/
├── ISSUE_TEMPLATE/ # Issue templates (7 files)
│ ├── config.yml
│ ├── marketplace-issue.yml
│ ├── new-skill-proposal.yml
│ ├── skill-bug-report.yml
│ ├── skill-documentation.yml
│ ├── skill-enhancement.yml
│ └── skill-optimization.yml
└── workflows/ # GitHub Actions (2 files)
├── validate-frontmatter.yml
└── validate-json-schemas.yml
Purpose: Automated CI validation for YAML frontmatter and JSON schemas, plus structured issue templates for skill proposals, bug reports, and enhancements.
Slash commands for interactive Claude Code workflows.
commands/
├── README.md # Command documentation
├── continue-session.md # Resume previous work sessions
├── explore-idea.md # Pre-planning exploration
├── plan-feature.md # Feature planning workflow
├── plan-project.md # Project planning generator
├── release.md # Pre-release safety checks
├── workflow.md # Interactive guidance
└── wrap-session.md # Session checkpoint/summary
Usage: Type /plan-project, /explore-idea, etc. in Claude Code CLI.
Comprehensive documentation organized by purpose.
docs/
├── archive/ # Archived documents
│ └── lost-info.md # Information recovery tracking
├── getting-started/ # Onboarding guides (3 files, 28KB)
│ ├── ONE_PAGE_CHECKLIST.md # Quality verification checklist
│ ├── QUICK_WORKFLOW.md # 5-minute skill creation guide
│ └── START_HERE.md # First-time user guide
├── guides/ # Process guides (4 files, 65KB)
│ ├── CONTRIBUTING.md # Contribution guidelines
│ ├── ISSUE_TEMPLATES_GUIDE.md # Issue template usage
│ ├── MARKETPLACE_MANAGEMENT.md # Marketplace management details
│ └── PLUGIN_DEV_BEST_PRACTICES.md # Plugin development best practices
├── reference/ # Standards & reference (5 files, 45KB)
│ ├── COMMON_MISTAKES.md # Learn from past failures
│ ├── SKILL_CATEGORIZATION.md # Skill organization system
│ ├── STANDARDS_COMPARISON.md # Official vs our standards
│ ├── claude-code-skill-standards.md # Our skill standards
│ └── research-protocol.md # Research methodology
└── validation/ # Validation docs (3 files, 32KB)
├── IMPLEMENTATION.md # Implementation details
├── README.md # Validation overview
└── json-schema-validation.md # JSON schema validation guide
Key Documents:
getting-started/START_HERE.md- New user onboardingreference/claude-code-skill-standards.md- Primary standards referencereference/STANDARDS_COMPARISON.md- Alignment with official Anthropic standards
170 plugins organizing 211 individual skills by domain.
Each plugin follows this structure:
plugins/<plugin-name>/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── agents/ # Agent definitions (optional)
├── commands/ # Plugin commands (optional)
├── hooks/ # Hook scripts (optional)
└── skills/ # Individual skill directories
└── <skill-name>/
├── SKILL.md # Main skill content
├── README.md # Public documentation
├── references/ # Extended documentation
├── templates/ # Code templates
├── scripts/ # Helper scripts
└── assets/ # Images, diagrams, data
| Plugin | Skills | Description |
|---|---|---|
| bun | 27 | Bundler, Cloudflare Workers, Docker, Drizzle, FFI, File I/O, Hono, Hot Reloading, HTTP Server, Jest Migration, Macros, Next.js, Nuxt, Package Manager, React SSR, Redis, Runtime, Shell, SQLite, SvelteKit, TanStack Start, Test Basics/Coverage/Lifecycle/Mocking, WebSocket Server, Workers |
| cloudflare-workers | 10 | Workers runtime, security, performance, CI/CD, dev experience, frameworks, migration, multi-lang, observability, runtime APIs |
| nuxt-v4 | 4 | Nuxt 4 core, UI, Content, SEO |
| nuxt-v5 | 4 | Nuxt 5 core, UI, Content, SEO |
- cloudflare-workers (10 skills), cloudflare-d1, cloudflare-r2, cloudflare-kv
- cloudflare-workers-ai, cloudflare-vectorize, cloudflare-queues, cloudflare-workflows
- cloudflare-durable-objects, cloudflare-agents, cloudflare-mcp-server, cloudflare-turnstile
- cloudflare-nextjs, cloudflare-cron-triggers, cloudflare-email-routing
- cloudflare-hyperdrive, cloudflare-images, cloudflare-browser-rendering
- cloudflare-zero-trust-access, cloudflare-manager, cloudflare-sandbox
- bun (bundler, cloudflare-workers, docker, drizzle, ffi, file-io, hono, hot-reloading, http-server, jest-migration, macros, nextjs, nuxt, package-manager, react-ssr, redis, runtime, shell, sqlite, sveltekit, tanstack-start, test-basics, test-coverage, test-lifecycle, test-mocking, websocket-server, workers)
- ai-sdk-core, ai-sdk-ui
- openai-api, openai-agents, openai-assistants, openai-responses
- google-gemini-api, google-gemini-embeddings, google-gemini-file-search
- claude-api, claude-agent-sdk
- elevenlabs-agents, thesys-generative-ui
- ai-elements-chatbot, better-chatbot, better-chatbot-patterns
- multi-ai-consultant, nano-banana-prompts
- gemini-cli, tanstack-ai
- nuxt-v4 (4 skills), nuxt-v5 (4 skills), nuxt-ui-v4, nuxt-content, nuxt-seo, nuxt-studio
- Component Libraries: tailwind-v4-shadcn, shadcn-vue, aceternity-ui, inspira-ui, base-ui-react, maz-ui
- Animation: auto-animate, motion
- State Management: zustand-state-management, pinia-v3, pinia-colada
- React: react-best-practices, react-composition-patterns, react-hook-form-zod, react-native-skills
- Design: frontend-design, design-review, design-system-creation, interaction-design, kpi-dashboard-design, mobile-first-design, responsive-web-design
- 3D: threejs
- Tooling: ultracite, zod
- nextjs, hono-routing, tanstack-query, tanstack-router, tanstack-start, tanstack-table
- api-changelog-versioning, api-contract-testing, api-design-principles
- api-error-handling, api-filtering-sorting, api-gateway-configuration
- api-pagination, api-rate-limiting, api-reference-documentation
- api-response-optimization, api-testing, api-versioning-strategy
- rest-api-design
- access-control-rbac, api-security-hardening, csrf-protection
- defense-in-depth-validation, security-headers-configuration
- vulnerability-scanning, xss-prevention
- better-auth, api-authentication, oauth-implementation, session-management
- database-schema-design, database-sharding
- drizzle-orm-d1, sql-query-optimization, supabase-postgres-best-practices
- sveltia-cms, content-collections, hugo (6.7MB)
- typescript-mcp, fastmcp, mcp-dynamic-orchestrator, mcp-management
- jest-generator, playwright, vitest-testing
- mutation-testing, test-quality-analysis
- react-native-skills, mobile-app-debugging, mobile-app-testing, mobile-offline-support
- architecture-patterns, microservices-patterns, technical-specification
- seo-optimizer, seo-keyword-cluster-builder, web-performance-optimization, web-performance-audit
- ml-model-training, ml-pipeline-automation, model-deployment
- recommendation-engine, recommendation-system
- wordpress-plugin-core
- woocommerce-backend-dev, woocommerce-code-review, woocommerce-copy-guidelines, woocommerce-dev-cycle
- swift-best-practices, swift-settingskit
- neon-vercel-postgres, vercel-kv, vercel-blob
- code-review, dependency-upgrade, verification-before-completion
- github-project-automation, claude-code-bash-patterns, claude-hook-writer
- systematic-debugging, root-cause-tracing, sequential-thinking
- feature-dev, design-review, plan-interview
- firecrawl-scraper, chrome-devtools, turborepo
- internationalization-i18n, logging-best-practices, idempotency-handling
- graphql-implementation, websocket-implementation, health-check-endpoints
- payment-gateway-integration, app-store-deployment
- progressive-web-app, push-notification-setup
- image-optimization
JSON Schema validation files for plugin and marketplace manifests.
schemas/
├── marketplace.schema.json # Marketplace JSON schema
└── plugin.schema.json # Plugin JSON schema
Usage: Validated by scripts/validate-json-schemas.sh and .github/workflows/validate-json-schemas.yml.
Automation and utility scripts for managing skills and plugins.
scripts/
├── lib/ # Shared script libraries
│ └── categorize.sh # Plugin categorization helper
├── sync-plugins.sh # Main entry point - syncs all plugin data
├── generate-marketplace.sh # Generate marketplace.json
├── install-skill.sh # Install single skill to ~/.claude/skills/
├── install-all.sh # Install all skills
├── check-versions.sh # Verify package versions are current
├── review-skill.sh # Automated skill review
├── audit-keywords.sh # Audit keyword quality
├── baseline-audit-all.sh # Baseline validation for all skills
├── release-check.sh # Pre-release verification
├── validate-frontmatter.sh # Validate YAML frontmatter in SKILL.md files
├── validate-json-schemas.sh # Validate plugin.json against schemas
├── remove-category-from-plugins.sh # Remove category field from plugin manifests
└── renumber-skills.py # Renumber skill ordering
Key Scripts:
sync-plugins.sh- Main workflow: Sync versions, categories, keywords, agents, commandsinstall-skill.sh- Test individual skills locallygenerate-marketplace.sh- Rebuild marketplace.json (called by sync-plugins.sh)baseline-audit-all.sh- Validate all 211 skills
Templates for creating new skills.
templates/
├── skill-skeleton/ # Complete skill directory structure
│ ├── .claude-plugin/
│ │ └── plugin.json # Template plugin manifest
│ ├── assets/ # Asset directory (empty)
│ ├── references/ # Reference docs directory (empty)
│ ├── scripts/ # Scripts directory (empty)
│ ├── SKILL.md # Main skill template with TODOs
│ └── README.md # Public doc template with TODOs
├── README-TEMPLATE.md # Standalone README template
└── SKILL-TEMPLATE.md # Standalone SKILL template
Usage:
cp -r templates/skill-skeleton/ plugins/<plugin-name>/skills/<skill-name>/
# Fill in TODOs in SKILL.md and README.mdclaude-skills/
├── CHANGELOG.md # Version history
├── CLAUDE.md # Project context for Claude Code
├── LICENSE # MIT License
├── MARKETPLACE.md # Marketplace overview
├── PROJECT_STRUCTURE.md # This file
├── README.md # Public repository overview
├── package.json # Node package config
└── plan.md # Planning notes
Navigation:
- New to repo? → Read docs/getting-started/START_HERE.md
- Building skills? → Read docs/getting-started/QUICK_WORKFLOW.md
- Verifying work? → Read docs/getting-started/ONE_PAGE_CHECKLIST.md
- Project context? → Read CLAUDE.md
Every skill follows this canonical structure:
<skill-name>/
├── .claude-plugin/
│ └── plugin.json # Auto-generated manifest
│ {
│ "name": "skill-name",
│ "description": "...",
│ "version": "3.0.0",
│ "keywords": [...],
│ "agents": [],
│ "commands": []
│ }
│
├── SKILL.md # Main skill content (<500 lines)
│ ---
│ name: skill-name
│ description: Brief description with "Use when" scenarios
│ license: MIT
│ ---
│
│ ## Quick Start
│ ## When to Load References (how to use references/)
│ ## Top 3-5 Errors (most critical issues)
│ ## [Condensed sections with pointers to references/]
│
├── README.md # Public documentation
│ (Auto-trigger keywords, installation, examples)
│
├── references/ # Extended documentation (loaded as needed)
│ ├── setup-guide.md
│ ├── advanced-features.md
│ ├── error-catalog.md
│ ├── troubleshooting.md
│ └── [domain-specific].md
│
├── templates/ # Code templates
│ ├── basic-setup.ts
│ ├── advanced-example.tsx
│ └── package.json
│
├── scripts/ # Helper scripts
│ ├── setup.sh
│ ├── check-versions.sh
│ └── install-dependencies.sh
│
└── assets/ # Images, diagrams, data
├── architecture-diagram.png
└── sample-data.json
Total: 3,008 files across 22.7MB
| Extension | Count | Purpose |
|---|---|---|
.md |
1,589 | Documentation (SKILL.md, README.md, references/) |
.ts |
369 | TypeScript templates and examples |
.json |
244 | Config files (plugin.json, package.json, schemas) |
.sh |
148 | Shell scripts for automation |
.html |
131 | HTML templates and examples |
.js |
476 | JavaScript examples, scripts, and helpers |
.tsx |
91 | React component templates |
| Other | ~160 | CSS, Python, Swift, YAML, config files |
Generated by codemap --deps:
JavaScript Dependencies: ai, openai, anthropic, google, workers-ai-provider, zod, react, react-dom, next, tailwindcss, vite, eslint, puppeteer, claude-agent-sdk, vitest, workers-types, wrangler, hono, cloudflare, drizzle-orm, drizzle-kit, playwright, bun, react-hook-form, react-query, react-router, react-table, genui-sdk, postcss, autoprefixer
Python Dependencies: fastmcp, httpx, python-dotenv, pydantic, openai, fastapi, uvicorn, flask, flask-cors
Import Hubs (most-referenced files):
plugins/drizzle-orm-d1/.../templates/schema(5 importers)plugins/chrome-devtools/.../scripts/lib/browser(5 importers)plugins/chrome-devtools/.../scripts/lib/selector(3 importers)plugins/mcp-dynamic-orchestrator/.../src/orchestrator(2 importers)plugins/tanstack-query/.../examples/react-native(2 importers)
Stats: 560 files, 5,891 functions, 21 dependencies
This repository uses a two-tier architecture:
- What: Logical groupings of related skills
- Where:
plugins/<plugin-name>/ - Purpose: Organize skills by domain for discoverability
- Discovery: Listed in
.claude-plugin/marketplace.json - Installation:
/plugin install <plugin-name>@claude-skills
- What: Individual knowledge units Claude loads
- Where:
plugins/<plugin-name>/skills/<skill-name>/ - Purpose: Provide specific domain expertise
- Discovery: Auto-loaded when relevant to user tasks
- Content: SKILL.md, templates, references, scripts
Example:
Plugin: "bun" (1 of 170)
↓ contains
Skills: bun-bundler, bun-cloudflare-workers, bun-docker, ... (27 total)
Plugin: "cloudflare-workers" (1 of 170)
↓ contains
Skills: workers-runtime-apis, workers-security, workers-performance, ... (10 total)
# Copy template
cp -r templates/skill-skeleton/ plugins/<plugin>/skills/<skill-name>/
# Edit SKILL.md and README.md (fill TODOs)
# Add templates, references, scripts
# Test locally
./scripts/install-skill.sh <skill-name>
# Sync plugin data
./scripts/sync-plugins.sh
# Commit
git add plugins/<plugin>/skills/<skill-name>
git commit -m "Add <skill-name> skill"# Automatic (recommended)
./scripts/sync-plugins.sh
# Manual (if needed)
./scripts/generate-marketplace.sh# Check package versions
./scripts/check-versions.sh plugins/<plugin>/skills/<skill-name>/
# Review skill quality
./scripts/review-skill.sh <skill-name>
# Baseline audit
./scripts/baseline-audit-all.sh
# Validate frontmatter
./scripts/validate-frontmatter.sh
# Validate JSON schemas
./scripts/validate-json-schemas.sh# Single skill
./scripts/install-skill.sh <skill-name>
# All skills
./scripts/install-all.sh
# Verify
ls -la ~/.claude/skills/# Full tree
codemap .
# Limit depth
codemap --depth 2 .
# Show dependencies
codemap --deps .
# Files changed vs main
codemap --diff
# Check importers
codemap --importers <file>
# Filter by extension
codemap --only ts,tsx,md .# All SKILL.md files
find plugins -name "SKILL.md"
# All plugin.json manifests
find plugins -name "plugin.json"
# All templates
find plugins -name "templates" -type d
# TypeScript templates
find plugins/*/skills/*/templates -name "*.ts"Frequently accessed locations:
| Path | Description |
|---|---|
plugins/bun/ |
Bun skills (27 skills) |
plugins/cloudflare-workers/ |
Cloudflare Workers skills (10 skills) |
plugins/cloudflare-d1/ |
Cloudflare D1 database skill |
plugins/nextjs/ |
Next.js skill |
plugins/better-auth/ |
Better Auth skill (largest single-skill plugin) |
templates/skill-skeleton/ |
New skill template |
scripts/sync-plugins.sh |
Main sync script |
.claude-plugin/marketplace.json |
Marketplace manifest |
docs/reference/claude-code-skill-standards.md |
Standards |
docs/getting-started/ONE_PAGE_CHECKLIST.md |
Quality checklist |
schemas/plugin.schema.json |
Plugin JSON schema |
.github/workflows/ |
CI validation workflows |
Repository:
- Total Size: 22.7MB (3,008 files)
- Total Plugins: 170
- Total Skills: 211
File Types:
- Markdown: 1,589 files (documentation)
- JavaScript: 476 files (scripts, helpers)
- TypeScript: 369 files (templates)
- JSON: 244 files (config)
- Shell: 148 files (automation)
- HTML: 131 files (templates)
Skills by Category:
- Cloudflare: 23 skills (21 plugins)
- Bun: 27 skills (1 plugin)
- AI/ML: 20 skills (20 plugins)
- Nuxt: 14 skills (5 plugins)
- Frontend & UI: 30+ skills
- API: 13 skills (13 plugins)
- Testing: 5 skills (5 plugins)
- Security: 7 skills (7 plugins)
- Auth: 4 skills (4 plugins)
- Database: 5 skills (5 plugins)
- WooCommerce: 4 skills (4 plugins)
- Swift: 2 skills (2 plugins)
Largest Plugins (by file count):
- playwright (539 files, 13MB)
- hugo (423 files, 6.7MB)
- cloudflare-workers (119 files, 1.3MB)
- cloudflare-images (63 files, 640KB)
- react-best-practices (65 files, 328KB)
- nuxt-ui-v4 (78 files, 656KB)
- maz-ui (46 files, 668KB)
- cloudflare-durable-objects (49 files, 632KB)
- bun (46 files, 324KB)
- better-auth (45 files, 500KB)
- First time here? → Read docs/getting-started/START_HERE.md
- Want to create a skill? → Read docs/getting-started/QUICK_WORKFLOW.md
- Need project context? → Read CLAUDE.md
- Quality verification? → Read docs/getting-started/ONE_PAGE_CHECKLIST.md
Last Updated: 2026-04-08 Generated with: codemap Maintained by: Claude Skills Team