Auto Skill Builder

What it does

When your agent uses it

• Creating a skill from documentation, specs or a repository
• Refactoring a skill that is too long or fires at the wrong times
• Splitting a large skill into a quick reference plus a references folder
• Adding a quality gate checklist and validator to a skill

Example prompts

• “Turn the Stripe webhooks docs into a skill with a quick reference and a references folder.”
• “Refactor my deploy skill. It is too long and triggers on unrelated requests.”
• “Generate a first-draft skill from this GitHub repository with Skill Seekers and import it.”

Requirements

• Skill Seekers, linked as a submodule and bootstrapped with the bundled script
• A shell to run the helper scripts

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1A concrete directory layout (typically skills//)
2. 2An actionable SKILL.md with decidable triggers, boundaries, and reproducible examples
3. 3Long-form docs moved to references/ with a references/index.md
4. 4A pre-delivery checklist (Quality Gate)

What it can do on your machine

Read from SKILL.md and the folder at commit 0a7fdf4. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 4 files in scripts/ (Shell, from the files we listed), which the agent can run.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • support.claude.com
  • docs.claude.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Auto Skill Builder loads about 2.4k tokens when it runs, and up to ~7.3k if it reads all its reference files. Until then it costs about 58 tokens; SKILL.md has 567 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~58

When it runs · the whole SKILL.md, loaded when a task matches

~2.4k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~7.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from tradecatlabs/vibe-coding-cn at commit 0a7fdf4, republished under its MIT licence (© tradecatlabs). 567 words, ~2,368 tokens.

name

auto-skill

description

Claude Skills meta-skill: extract domain material (docs/APIs/code/specs) into a reusable Skill (SKILL.md + references/scripts/assets), and refactor existing Skills for clarity, activation reliability, and quality gates.

./skills/auto-skill/scripts/skill-seekers-bootstrap.sh

./skills/auto-skill/scripts/skill-seekers.sh -- --version
./skills/auto-skill/scripts/skill-seekers.sh -- scrape --config ./skills/auto-skill/scripts/Skill_Seekers-development/configs/react.json
./skills/auto-skill/scripts/skill-seekers.sh -- github --repo facebook/react --name react

./skills/auto-skill/scripts/skill-seekers-import.sh react
./skills/auto-skill/scripts/skill-seekers-import.sh react --force

./skills/auto-skill/scripts/skill-seekers-update.sh --dry-run

skill-name/
|-- SKILL.md              # Required: entrypoint with YAML frontmatter
|-- references/           # Optional: long-form docs/evidence/index
|   `-- index.md          # Recommended: navigation index
|-- scripts/              # Optional: helpers/automation
`-- assets/               # Optional: templates/configs/static assets

---
name: skill-name
description: "What it does + when to use (activation triggers)."
---

---
name: my-skill
description: "[Domain] capability: includes [capability 1], [capability 2]. Use when [decidable triggers]."
---

# my-skill Skill

One sentence that states the boundary and the deliverable.

## When to Use This Skill

Trigger when any of these applies:
- [Trigger 1: concrete task/keyword]
- [Trigger 2]
- [Trigger 3]

## Not For / Boundaries

- What this skill will not do (prevents misfires and over-promising)
- Required inputs; ask 1-3 questions if missing

## Quick Reference

### Common Patterns

**Pattern 1:** one-line explanation
```text
[command/snippet you can paste and run]

### Authoring Rules (Non-negotiable)

1. Quick Reference is for short, directly usable patterns
   - Keep it <= 20 patterns when possible.
   - Anything that needs paragraphs of explanation goes to `references/`.
2. Activation must be decidable
   - Frontmatter `description` should say "what + when" with concrete keywords.
   - "When to Use" must list specific tasks/inputs/goals, not vague help text.
   - "Not For / Boundaries" is mandatory for reliability.
3. No bluffing on external details
   - If the material does not prove it, say so and include a verification path.

### Workflow (Material -> Skill)

Do not skip steps:
0. If your source material is a docs site / GitHub repo / PDF: generate a first draft with the linked Skill Seekers tool, then import into `skills/<skill-name>/`
1. Scope: write MUST/SHOULD/NEVER (three sentences total is fine)
2. Extract patterns: pick 10-20 high-frequency patterns (commands/snippets/flows)
3. Add examples: >= 3 end-to-end examples (input -> steps -> acceptance)
4. Define boundaries: what is out-of-scope + required inputs
5. Split references: move long text into `references/` + write `references/index.md`
6. Apply the gate: run the checklist and the validator

### Quality Gate (Pre-delivery Checklist)

Minimum checks (see `references/quality-checklist.md` for the full version):
1. `name` matches `^[a-z][a-z0-9-]*$` and matches the directory name
2. `description` states "what + when" with concrete trigger keywords
3. Has "When to Use This Skill" with decidable triggers
4. Has "Not For / Boundaries" to reduce misfires
5. Quick Reference is <= 20 patterns and each is directly usable
6. Has >= 3 reproducible examples
7. Long content is in `references/` and `references/index.md` is navigable
8. Uncertain claims include a verification path (no bluffing)
9. Reads like an operator's manual, not a documentation dump

Validate locally:

```bash
# From repo root (basic validation)
./skills/auto-skill/scripts/validate-skill.sh skills/<skill-name>

# From repo root (strict validation)
./skills/auto-skill/scripts/validate-skill.sh skills/<skill-name> --strict

# From skills/auto-skill/ (basic validation)
./scripts/validate-skill.sh ../<skill-name>

# From skills/auto-skill/ (strict validation)
./scripts/validate-skill.sh ../<skill-name> --strict

# From repo root (generate into ./skills/)
./skills/auto-skill/scripts/create-skill.sh my-skill --full --output skills

# From auto-skill/ (generate into ../ i.e. ./skills/)
./scripts/create-skill.sh my-skill --full --output ..

# Minimal skeleton
./skills/auto-skill/scripts/create-skill.sh my-skill --minimal --output skills

© tradecatlabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 24 other files (scripts, references, assets) in skills/auto-skill of tradecatlabs/vibe-coding-cn.

• SKILL.md
• AGENTS.md
• README.md
• assets/AGENTS.md
• assets/README.md
• assets/template-complete.md
• assets/template-minimal.md
• references/AGENTS.md
• references/README.md
• references/anti-patterns.md
• references/index.md
• references/quality-checklist.md
• references/skill-seekers.md
• references/skill-spec.md
• scripts/AGENTS.md
• scripts/README.md
• scripts/Skill_Seekers-development
• scripts/create-skill.sh
• … and 7 more

Open the folder on GitHubat commit 0a7fdf4

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in tradecatlabs/vibe-coding-cn, which our catalogue first saw on October 7, 2026.

• ziiyuecheng/vibe-coding-cnskills/auto-skill