Skills for Real Engineers. Straight from my .agents directory.
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
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)
1# Skill Forge23IRON 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.45## What is a Skill67A 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.89```10skill-name/11├── SKILL.md # Required: workflow + instructions (<500 lines)12├── scripts/ # Optional: deterministic, repeatable operations13├── references/ # Optional: loaded into context on demand14└── assets/ # Optional: used in output, never loaded into context15```1617**Default assumption: Claude is already very smart.** Only add what Claude doesn't already know. Challenge every paragraph: "Does this justify its token cost?"1819## Workflow2021Copy this checklist and check off items as you complete them:2223```24Skill Forge Progress:2526- [ ] Step 1: Understand the Skill ⚠️ REQUIRED27 - [ ] 1.1 Clarify purpose and concrete use cases28 - [ ] 1.2 Collect 3+ concrete usage examples29 - [ ] 1.3 Identify trigger scenarios and keywords30- [ ] Step 2: Plan Architecture31 - [ ] 2.1 Identify reusable resources (scripts, references, assets)32 - [ ] 2.2 Design progressive loading strategy33 - [ ] 2.3 Design parameter system (if applicable)34- [ ] Step 3: Initialize ⛔ BLOCKING (skip if skill already exists)35 - [ ] Run init_skill.py36- [ ] Step 4: Write Description37…
Excerpt shown under the repository's MIT license.
More skills in sanyuan-skills
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
