Skill Forge IRON 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. What is a Skill A 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. Default assumption: Claude is already very smart. Only add what Claude doesn't already know. Challenge every paragraph: "Does this justify its token cost?" Workflow Copy this checklist and check off items as you complete them: Step 1: Underst…

, name):\n return False, f\"Name '{name}' should be hyphen-case (lowercase letters, digits, and hyphens only)\"\n if name.startswith('-') or name.endswith('-') or '--' in name:\n return False, f\"Name '{name}' cannot start/end with hyphen or contain consecutive hyphens\"\n if len(name) > 64:\n return False, f\"Name is too long ({len(name)} characters). Maximum is 64 characters.\"\n\n # Validate description\n description = frontmatter.get('description', '')\n if not isinstance(description, str):\n return False, f\"Description must be a string, got {type(description).__name__}\"\n description = description.strip()\n if description:\n if '\u003c' in description or '>' in description:\n return False, \"Description cannot contain angle brackets (\u003c or >)\"\n if len(description) > 1024:\n return False, f\"Description is too long ({len(description)} characters). Maximum is 1024 characters.\"\n\n return True, \"Skill is valid!\"\n\n\nif __name__ == \"__main__\":\n if len(sys.argv) != 2:\n print(\"Usage: python quick_validate.py \u003cskill_directory>\")\n sys.exit(1)\n\n valid, message = validate_skill(sys.argv[1])\n print(message)\n sys.exit(0 if valid else 1)\n","content_type":"text/x-python; charset=utf-8","language":"python","size":3218,"content_sha256":"65bd55ae751398188c4de7a8746a70137bb15d8a8d0d07c773b4c74239ddcb34"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Skill Forge","type":"text"}]},{"type":"paragraph","content":[{"text":"IRON 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.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"What is a Skill","type":"text"}]},{"type":"paragraph","content":[{"text":"A 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.","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"skill-name/\n├── SKILL.md # Required: workflow + instructions (\u003c500 lines)\n├── scripts/ # Optional: deterministic, repeatable operations\n├── references/ # Optional: loaded into context on demand\n└── assets/ # Optional: used in output, never loaded into context","type":"text"}]},{"type":"paragraph","content":[{"text":"Default assumption: Claude is already very smart.","type":"text","marks":[{"type":"strong"}]},{"text":" Only add what Claude doesn't already know. Challenge every paragraph: \"Does this justify its token cost?\"","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Workflow","type":"text"}]},{"type":"paragraph","content":[{"text":"Copy this checklist and check off items as you complete them:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Skill Forge Progress:\n\n- [ ] Step 1: Understand the Skill ⚠️ REQUIRED\n - [ ] 1.1 Clarify purpose and concrete use cases\n - [ ] 1.2 Collect 3+ concrete usage examples\n - [ ] 1.3 Identify trigger scenarios and keywords\n- [ ] Step 2: Plan Architecture\n - [ ] 2.1 Identify reusable resources (scripts, references, assets)\n - [ ] 2.2 Design progressive loading strategy\n - [ ] 2.3 Design parameter system (if applicable)\n- [ ] Step 3: Initialize ⛔ BLOCKING (skip if skill already exists)\n - [ ] Run init_skill.py\n- [ ] Step 4: Write Description\n - [ ] Load references/description-guide.md\n - [ ] Apply keyword bombing technique\n- [ ] Step 5: Write SKILL.md Body\n - [ ] 5.1 Set Iron Law\n - [ ] 5.2 Design workflow checklist\n - [ ] 5.3 Add confirmation gates\n - [ ] 5.4 Add parameter system (if applicable)\n - [ ] 5.5 Apply writing techniques\n - [ ] 5.6 Add anti-patterns list\n - [ ] 5.7 Add pre-delivery checklist\n- [ ] Step 6: Build Resources\n - [ ] 6.1 Implement and test scripts\n - [ ] 6.2 Write reference files\n - [ ] 6.3 Prepare assets\n- [ ] Step 7: Review ⚠️ REQUIRED\n - [ ] Run pre-delivery checklist (Step 9)\n - [ ] Present summary to user for confirmation\n- [ ] Step 8: Package\n - [ ] Run package_skill.py\n- [ ] Step 9: Iterate based on real usage","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 1: Understand the Skill ⚠️ REQUIRED","type":"text"}]},{"type":"paragraph","content":[{"text":"Ask yourself:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What specific problem does this skill solve that Claude can't do well on its own?","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What would a user literally type to trigger this skill?","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What are 3-5 concrete usage examples with realistic inputs and expected outputs?","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If unclear, ask the user (don't ask everything at once — start with the most critical):","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"Can you give me 3 examples of how you'd use this skill?\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"What would you literally say to trigger it?\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"What does a good output look like?\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Do NOT proceed until you have at least 3 concrete examples.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 2: Plan Architecture","type":"text"}]},{"type":"paragraph","content":[{"text":"For each concrete example, ask:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What operations are deterministic and repeatable? → ","type":"text"},{"text":"scripts/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What domain knowledge does Claude need at specific steps? → ","type":"text"},{"text":"references/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What files are used in output but not in reasoning? → ","type":"text"},{"text":"assets/","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"paragraph","content":[{"text":"Key constraints:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"SKILL.md must stay under 500 lines — everything else goes to ","type":"text"},{"text":"references/","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"References organized by domain, one level of nesting only","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Load references/architecture-guide.md for progressive loading patterns and organization strategies","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 3: Initialize ⛔ BLOCKING","type":"text"}]},{"type":"paragraph","content":[{"text":"Skip if working on an existing skill. Otherwise run:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"python3 scripts/init_skill.py \u003cskill-name> --path \u003coutput-directory>","type":"text"}]},{"type":"paragraph","content":[{"text":"The script creates a template with Iron Law placeholder, workflow checklist, and proper directory structure.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 4: Write Description","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the most underestimated part of a skill. The description determines:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Whether the skill triggers automatically","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Whether users find it by search","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Load references/description-guide.md for the keyword bombing technique and good/bad examples.","type":"text"}]},{"type":"paragraph","content":[{"text":"Key rule: NEVER put \"When to Use\" info in the SKILL.md body. The body loads AFTER triggering — too late.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 5: Write SKILL.md Body","type":"text"}]},{"type":"paragraph","content":[{"text":"Load reference files as needed for each sub-step:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.1 Set Iron Law","type":"text"}]},{"type":"paragraph","content":[{"text":"Ask: \"What is the ONE mistake the model will most likely make with this skill?\" Write a rule that prevents it. Place it at the top of SKILL.md, right after the frontmatter.","type":"text"}]},{"type":"paragraph","content":[{"text":"→ Load references/writing-techniques.md for Iron Law patterns and red flag signals.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.2 Design Workflow Checklist","type":"text"}]},{"type":"paragraph","content":[{"text":"Create a trackable checklist with:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"⚠️ REQUIRED for steps that must not be skipped","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"⛔ BLOCKING for prerequisites","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Sub-step nesting for complex steps","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"(conditional) for steps that depend on earlier choices","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"→ Load references/workflow-patterns.md for checklist patterns and examples.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.3 Add Confirmation Gates","type":"text"}]},{"type":"paragraph","content":[{"text":"Force the model to stop and ask the user before:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Destructive operations (delete, overwrite, modify)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Generative operations with significant cost","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Applying changes based on analysis","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"→ Load references/workflow-patterns.md for confirmation gate patterns.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.4 Add Parameter System (if applicable)","type":"text"}]},{"type":"paragraph","content":[{"text":"If the skill benefits from flags like ","type":"text"},{"text":"--quick","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--style","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"--regenerate N","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"text":"→ Load references/parameter-system.md for $ARGUMENTS, flags, argument-hint, and partial execution patterns.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.5 Apply Writing Techniques","type":"text"}]},{"type":"paragraph","content":[{"text":"Three techniques that dramatically improve output quality:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Question-style instructions","type":"text","marks":[{"type":"strong"}]},{"text":": Give questions, not vague directives","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Anti-pattern documentation","type":"text","marks":[{"type":"strong"}]},{"text":": List what NOT to do","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Iron Law + Red Flags","type":"text","marks":[{"type":"strong"}]},{"text":": Prevent the model from taking shortcuts","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"→ Load references/writing-techniques.md for all three with examples.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.6 Add Anti-Patterns List","type":"text"}]},{"type":"paragraph","content":[{"text":"Ask: \"What would Claude's lazy default look like for this task?\" Then explicitly forbid it.","type":"text"}]},{"type":"paragraph","content":[{"text":"→ Load references/writing-techniques.md for anti-pattern examples.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"5.7 Add Pre-Delivery Checklist","type":"text"}]},{"type":"paragraph","content":[{"text":"Add concrete, verifiable checks. Each item must be specific enough that the model can check it by looking at the output. Not \"ensure good quality\" but \"no placeholder text remaining (TODO, FIXME, xxx).\"","type":"text"}]},{"type":"paragraph","content":[{"text":"→ Load references/output-patterns.md for checklist patterns and priority-based output.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Writing Principles","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Concise","type":"text","marks":[{"type":"strong"}]},{"text":": Only add what Claude doesn't already know","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Imperative form","type":"text","marks":[{"type":"strong"}]},{"text":": \"Analyze the input\" not \"You should analyze the input\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Match freedom to fragility","type":"text","marks":[{"type":"strong"}]},{"text":": Narrow bridge → specific guardrails; open field → many routes","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"High freedom (text): multiple valid approaches","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Medium (pseudocode/params): preferred pattern, some variation OK","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Low (specific scripts): fragile operations, consistency critical","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 6: Build Resources","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Scripts","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Encapsulate deterministic, repeatable operations","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Scripts execute without loading into context — major token savings","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Test every script before packaging","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"In SKILL.md, document only the command and arguments, not the source code","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"References","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Organize by domain, not by type","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"One level of nesting only","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Each file referenced from SKILL.md with clear \"when to load\" instructions","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Large files (>100 lines) should have a table of contents at the top","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Assets","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Templates, images, fonts used in output","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Not loaded into context, just referenced by path","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"→ Load references/architecture-guide.md for detailed patterns.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 7: Review ⚠️ REQUIRED","type":"text"}]},{"type":"paragraph","content":[{"text":"Present the skill summary to the user and confirm before packaging.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Pre-Delivery Checklist","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Structure","type":"text"}]},{"type":"checkbox_list","attrs":{"id":null},"content":[{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"SKILL.md under 500 lines","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"Frontmatter has ","type":"text"},{"text":"name","type":"text","marks":[{"type":"code_inline"}]},{"text":" and ","type":"text"},{"text":"description","type":"text","marks":[{"type":"code_inline"}]},{"text":" only (plus optional ","type":"text"},{"text":"allowed-tools","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"license","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"metadata","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"Description includes trigger keywords and usage scenarios","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"No README.md, CHANGELOG.md, or other unnecessary files","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"No example/placeholder files left from initialization","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Quality","type":"text"}]},{"type":"checkbox_list","attrs":{"id":null},"content":[{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"Has an Iron Law or core constraint at the top","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"Has a trackable workflow checklist with ⚠️/⛔ markers","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"Confirmation gates before destructive/generative operations","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"Uses question-style instructions, not vague directives","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"Lists anti-patterns (what NOT to do)","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"References loaded progressively, not all upfront","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Resources","type":"text"}]},{"type":"checkbox_list","attrs":{"id":null},"content":[{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"Scripts tested and executable","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"References organized by domain, one level deep","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"Large references have table of contents","type":"text"}]}]},{"type":"checkbox_item","attrs":{"checked":false},"content":[{"type":"paragraph","content":[{"text":"Assets used in output, not loaded into context","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Anti-Patterns to Avoid","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Stuffing everything into one massive SKILL.md (>500 lines)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Vague description like \"A tool for X\"","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"No workflow — letting the model freestyle","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"No confirmation gates — model runs unchecked to completion","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Vague instructions like \"ensure good quality\" instead of specific checks","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Including README.md, INSTALLATION_GUIDE.md, or other documentation files","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"\"When to Use\" info in the body instead of the description field","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 8: Package","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"python3 scripts/package_skill.py \u003cpath/to/skill-folder> [output-directory]","type":"text"}]},{"type":"paragraph","content":[{"text":"Validates automatically before packaging. Fix errors and re-run.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Step 9: Iterate","type":"text"}]},{"type":"paragraph","content":[{"text":"After real usage:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Notice where the model struggles or is inconsistent","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Identify which workflow step needs improvement","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Add more specific instructions, examples, or anti-patterns","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Re-test and re-package","type":"text"}]}]}]}]},"metadata":{"date":"2026-11-02","name":"skill-forge","author":"@skillopedia","source":{"stars":3973,"repo_name":"sanyuan-skills","origin_url":"https://github.com/sanyuan0704/sanyuan-skills/blob/HEAD/skills/skill-forge/SKILL.md","repo_owner":"sanyuan0704","body_sha256":"667e8c1d9680f0aac486abdb2d0e02834e3626873a9bd53efdaf9f0fb80b9769","cluster_key":"78cc89add7d45a4e92ff84125b6ef8d89bfee7d366cb16f977cce64769de7105","clean_bundle":{"format":"clean-skill-bundle-v1","source":"sanyuan0704/sanyuan-skills/skills/skill-forge/SKILL.md","text_bytes":38832,"source_commit":"08b6572ef108f22d4e8a3ecf9182a4bbef097744","skills_sh_rank":4962,"attachment_count":10,"text_attachments":10,"attachment_storage":"skill_attachments","binary_attachments":0},"cluster_size":1,"skill_md_path":"skills/skill-forge/SKILL.md","import_metadata":{"date":"2026-11-02","author":"@skillopedia","version":"v1","category":"general","category_label":"General"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"general","import_tag":"skills-sh-top20k-2026-11","description":"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'."}},"renderedAt":1793666570355}

Skill Forge IRON 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. What is a Skill A 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. Default assumption: Claude is already very smart. Only add what Claude doesn't already know. Challenge every paragraph: "Does this justify its token cost?" Workflow Copy this checklist and check off items as you complete them: Step 1: Underst…