Tooluck logoTooluck
SKILL.md

skill-forge

Agent skill fromsanyuan0704/sanyuan-skills

Create high-quality, production-grade skills for Claude Code. Expert guidance on skill architecture, workflow design, prompt engineering, and packaging. Use when user wants to create a new skill, build a skill, design a skill, write a skill, update an existing skill, improve a skill, refactor a skill, debug a skill, or package a skill. Triggers: 'create skill', 'build skill', 'new skill', 'skill creation', 'write a skill', 'make a skill', 'design a skill', 'improve skill', 'package skill', 'skill development', 'skill template', 'skill best practices', 'write SKILL.md'.

How to install skill-forge

install skill-forge
# install the sanyuan-skills pack with the skills CLI
npx skills add sanyuan0704/sanyuan-skills

# or add only this skill to Claude Code: copy the folder

skills/skill-forge/

# into

~/.claude/skills/skill-forge/ (all projects)

.claude/skills/skill-forge/ (one project)

skills/skill-forge/SKILL.md

MITFull file
1# Skill Forge
2
3IRON LAW: Every line in a skill must justify its token cost. If it doesn't make the model's output better, more consistent, or more reliable — cut it.
4
5## What is a Skill
6
7A skill is an "onboarding guide" for Claude — transforming it from a general-purpose agent into a specialized one with procedural knowledge, domain expertise, and bundled tools.
8
9```
10skill-name/
11├── SKILL.md # Required: workflow + instructions (<500 lines)
12├── scripts/ # Optional: deterministic, repeatable operations
13├── references/ # Optional: loaded into context on demand
14└── assets/ # Optional: used in output, never loaded into context
15```
16
17**Default assumption: Claude is already very smart.** Only add what Claude doesn't already know. Challenge every paragraph: "Does this justify its token cost?"
18
19## Workflow
20
21Copy this checklist and check off items as you complete them:
22
23```
24Skill Forge Progress:
25
26- [ ] Step 1: Understand the Skill ⚠️ REQUIRED
27 - [ ] 1.1 Clarify purpose and concrete use cases
28 - [ ] 1.2 Collect 3+ concrete usage examples
29 - [ ] 1.3 Identify trigger scenarios and keywords
30- [ ] Step 2: Plan Architecture
31 - [ ] 2.1 Identify reusable resources (scripts, references, assets)
32 - [ ] 2.2 Design progressive loading strategy
33 - [ ] 2.3 Design parameter system (if applicable)
34- [ ] Step 3: Initialize ⛔ BLOCKING (skip if skill already exists)
35 - [ ] Run init_skill.py
36- [ ] Step 4: Write Description
37…

Excerpt shown under the repository's MIT license.

More skills in sanyuan-skills

Keep exploring

Similar skill repositories

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates