skill-gen-agent

Create, refactor, validate, and test Claude Code Skill packages with scripted pipelines.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/Simon-YHKim/eject-button --skill skill-gen-agent-simon-yhkim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-gen-agent
Source: https://github.com/Simon-YHKim/eject-button/tree/main/.claude/skills/skill-gen-agent
Command: npx skills add https://github.com/Simon-YHKim/eject-button --skill skill-gen-agent-simon-yhkim

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Writing a Claude Code Skill that actually triggers reliably and follows Anthropic's progressive-disclosure guidelines is error-prone: descriptions under-trigger, SKILL.md files bloat past 500 lines, and nobody validates or tests the result. This Skill turns an idea into a validated, versioned skill package through a structured five-mode workflow. ## Core Features & Use Cases - Five operating modes: create (7-step gated pipeline with interview, eval design, scaffolding, validation, testing, versioning), refactor (analyze plus safe auto-fixes), validate, test, and version bumping. - Best-practices enforcement: bundled validator checks frontmatter constraints, third-person descriptions, kebab-case naming, the 500-line rule, nested references, Windows paths, and placeholder markers. - Evaluation-driven development: designs eval cases before writing SKILL.md, then runs them via a subagent harness and grades outcomes. - Bilingual workflow: interacts in Korean or English while always producing English skill artifacts with verbatim trigger phrases in both languages. - Use Case: A user says "make a skill that converts CSV to Markdown" — the agent interviews them, drafts eval cases, scaffolds the package from templates, validates it, tests it, and logs version 0.1.0. ## Quick Start Ask the agent to create a new skill for your task, for example by saying "create a skill that converts CSV files to Markdown tables", and it will guide you through the full pipeline.

Frequently Asked Questions about skill-gen-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Claude Code Skill from scratch?

Use the create mode, which runs a 7-step gated pipeline: interview for intent, design eval cases, research dependencies, scaffold from the SKILL.md template, validate with validate_skill.py, test with a subagent harness, and log version 0.1.0.

How do I validate a SKILL.md against best practices?

Run scripts/validate_skill.py on the skill directory. It checks frontmatter validity, name and description constraints, third-person voice, the 500-line body ceiling, placeholder markers, Windows paths, nested references, and broken links, exiting non-zero on errors.

What makes a skill description trigger reliably?

Write it in third person, lead with "Use when...", include verbatim trigger phrases users actually type (including non-English ones), mention file extensions and tool names, state the output, and stay under 1024 characters.

Can the refactor mode fix my existing skill automatically?

Yes, refactor_skill.py --fix applies safe mechanical fixes: inserting TOCs into long reference files, converting Windows backslash paths, stripping trailing whitespace, ensuring final newlines, and normalizing CRLF. Semantic issues like first-person descriptions require manual repair.

Does it support Korean users?

Yes. The agent detects Korean from the first message and chats in Korean, but writes SKILL.md and all artifacts in English for reliable triggering. Descriptions include both English and Korean verbatim trigger phrases.

What are the limitations of the auto-fix mode?

Auto-fix only handles mechanical transformations and is idempotent. It cannot fix first-person descriptions, reserved words in names, TODO markers, nested reference links, or bodies over 500 lines — those are reported by --analyze for manual refactoring.