skill-development

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

Tools for creating, auditing, and maintaining Claude Code skills. Includes /create-skill for scaffolding, /review-skill for quality checks, and /audit commands for bulk verification. Use when: building new skills, maintaining skill quality, or forking claude-skills repo.

2installs

Sourcejezweb/claude-skills

Added on2026-02-07

NPX Install

npx skill4agent add jezweb/claude-skills skill-development

SKILL.md Content

View Translation Comparison →

Skill Development

Tools for creating, auditing, and maintaining Claude Code skills. Essential for anyone building skills or forking this repository.

Slash Commands

/create-skill <name>

Scaffold a new skill from templates.

What it does:

Validates skill name (lowercase-hyphen-case, max 40 chars)
Asks about skill type (Cloudflare/AI/Frontend/Auth/Database/Tooling/Generic)
Copies
```
templates/skill-skeleton/
```
to
```
skills/<name>/
```
Auto-populates name and dates in SKILL.md
Creates README.md with auto-trigger keywords
Runs metadata check
Installs skill for testing

Usage:

/create-skill my-new-skill

/review-skill <name>

Quality review and audit of an existing skill.

What it does:

Checks SKILL.md structure and metadata
Validates package versions against latest
Reviews error documentation
Checks template completeness
Suggests improvements

Usage:

/review-skill cloudflare-worker-base

/audit [name]

Multi-agent audit swarm for parallel skill verification.

What it does:

Launches parallel agents to audit multiple skills
Checks versions, metadata, content quality
Generates consolidated report

Usage:

```
/audit
```
- Audit all skills
```
/audit cloudflare-*
```
- Audit matching skills

/audit-skill-deep <name>

Deep content validation against official documentation.

What it does:

Fetches official documentation for the skill's technology
Compares patterns and versions
Identifies knowledge gaps or outdated content
Suggests corrections and updates

Usage:

/audit-skill-deep tailwind-v4-shadcn

/deep-audit <name>

Extended deep audit with comprehensive doc scraping.

What it does:

Scrapes multiple documentation sources
Caches scraped content in
```
archive/audit-cache/
```
Cross-references with skill content
Produces detailed accuracy report

Usage:

/deep-audit openai-api

/scrape-api <docs-url> [skill-name]

Generate a skill from API documentation URL.

What it does:

Validates the docs URL is accessible and contains API documentation
Attempts WebFetch first for static docs
Falls back to Playwright for JS-heavy sites (readme.io, GitBook)
Extracts endpoints, authentication, request/response schemas
Generates complete skill structure with SKILL.md, references/, templates/
Runs plugin manifest generation

Usage:

/scrape-api https://api.example.com/docs my-api

/scrape-api https://rocketdotnet.readme.io/

(auto-detects name: rocket-net-api)

Supported Platforms:

readme.io documentation sites
Swagger/OpenAPI specs
GitBook documentation
Standard HTML API docs

Templates

This skill includes templates for creating new skills:

Template	Purpose
`templates/skill-skeleton/`	Complete skill directory to copy
`templates/SKILL-TEMPLATE.md`	SKILL.md with TODOs to fill
`templates/README-TEMPLATE.md`	README.md with keywords section
`templates/skill-metadata-v2.yaml`	YAML frontmatter reference
`templates/RESEARCH_FINDINGS_TEMPLATE.md`	Research output format
`templates/CONTENT_AUDIT_TEMPLATE.md`	Audit checklist

Using Templates

bash

# Option 1: Use /create-skill (recommended)
/create-skill my-new-skill

# Option 2: Manual copy
cp -r skills/skill-development/templates/skill-skeleton/ skills/my-new-skill/
# Then fill in the TODOs

Quality Standards

Skills should meet these criteria before publishing:

Required

YAML frontmatter with
```
name
```
and
```
description
```
Description includes "Use when" scenarios
Third-person description style
Package versions are current
Templates tested and working

Agents

This skill provides agents for automated skill maintenance:

Agent	Purpose
`skill-creator`	Scaffold new skills with proper structure
`api-doc-scraper`	Generate skills from API documentation URLs
`version-checker`	Verify package versions are current
`content-accuracy-auditor`	Compare skill content vs official docs
`code-example-validator`	Validate code examples are syntactically correct
`api-method-checker`	Verify documented API methods exist
`doc-validator`	Check documentation quality
`bulk-updater`	Apply changes across multiple skills

These agents are in

.claude/agents/

(repo-level) and

agents/

(skill-bundled) and used by the commands.

Workflow

Creating a New Skill

1. /create-skill my-skill
2. Fill in TODOs in SKILL.md
3. Add templates, references, scripts as needed
4. /review-skill my-skill
5. Fix any issues
6. Test: /plugin install ./skills/my-skill
7. Commit and push

Auditing Skills

1. /audit                          # Quick check all skills
2. /audit-skill-deep my-skill      # Deep check specific skill
3. Review findings
4. Fix issues or document as known limitations
5. Update metadata.last_verified date

Quarterly Maintenance

1. Run: ./scripts/check-all-versions.sh
2. Review VERSIONS_REPORT.md
3. /audit for all skills needing updates
4. Update package versions
5. Test affected skills
6. Commit: "chore: quarterly version updates"

For Forkers

If you've forked this repo to maintain your own skills:

Install this skill:

/plugin install ./skills/skill-development

Use /create-skill: Creates skills with proper structure
Use /review-skill: Validates before publishing
Customize agents: Modify
```
.claude/agents/
```
for your needs

Pull upstream updates:

git fetch upstream && git merge upstream/main

The tooling is designed to work standalone - you don't need the full repo to use these commands.

skill-development

NPX Install

Tags

SKILL.md Content

Skill Development

Slash Commands

`/create-skill <name>`

`/review-skill <name>`

`/audit [name]`

`/audit-skill-deep <name>`

`/deep-audit <name>`

`/scrape-api <docs-url> [skill-name]`

Templates

Using Templates

Quality Standards

Required

Recommended

Agents

Workflow

Creating a New Skill

Auditing Skills

Quarterly Maintenance

For Forkers