new-skill-creator

Scaffold new Agent Skills with SKILL.md, optional protocol.yon, and tri-runtime symlinks.

14|1|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/allemaar/open-skills --skill new-skill-creator-allemaar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: new-skill-creator
Source: https://github.com/allemaar/open-skills/tree/main/skills/new-skill-creator
Command: npx skills add https://github.com/allemaar/open-skills --skill new-skill-creator-allemaar

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Creating a new Agent Skill by hand means getting the folder layout, frontmatter fields, runtime links, and git workflow right every time — and a mistake in any of them leaves the skill undiscoverable or half-linked. This Skill automates the maintainer's authoring loop end-to-end in a skills repo you own. ## Core Features & Use Cases - Guided scaffolding: Interviews you for name, description, triggers, visibility, and boundary clauses, then writes a compliant SKILL.md with correct frontmatter. - Single-doc or dual-doc formats: Applies an explicit criterion to decide between a plain SKILL.md and a dual-doc SKILL.md + protocol.yon pair, including validation via the YON parser. - Tri-runtime linking: Creates direct directory symlinks into Claude Code, Codex, and the shared .agents/ directory on Linux, macOS, and Windows, then commits and pushes. - Lifecycle operations: Includes procedures for migrating single-doc skills to dual-doc and renaming skills with full cross-reference sweeps and lint verification. - Use Case: You say "create a skill for reviewing release notes" and the Skill gathers requirements, scaffolds the folder, links it into all three runtimes, and pushes the commit. ## Quick Start Ask the agent to create a new skill named release-notes-review that triggers on phrases about reviewing release notes.

Frequently Asked Questions about new-skill-creator

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

FAQPage Schema
How do I create a new Agent Skill with a SKILL.md file?

Run the /new-skill-creator command or say "create a skill". The Skill interviews you for the name, description, trigger phrases, and visibility, then writes the folder and SKILL.md, links it into your runtimes, and pushes the commit.

When should a skill use the dual-doc SKILL.md and protocol.yon format?

Use dual-doc when the skill has three or more ordered phases, explicit gates or checks, decision tables, severity-ranked rules, or exceeds roughly 150 lines. Short routers, triggers, and reference cards stay single-doc.

Does this work with both Claude Code and Codex?

Yes. The Skill creates three parallel directory symlinks into ~/.claude/skills, ~/.codex/skills, and ~/.agents/skills so all runtimes read the same repo source. Runtime-specific skills can declare a restricted runtime list in frontmatter.

How do I rename an existing skill without breaking references?

Follow the rename procedure: rename the folder, update frontmatter and protocol.yon IDs, rebuild all three symlinks, sweep cross-references with grep, and run the lint tool. A dry-run on a throwaway branch is recommended first.

Why does linking fail on Windows with Git Bash?

On Windows, ln -s in Git Bash silently creates a directory copy instead of a symlink. Use cmd /c mklink /D or mklink /J instead, prefixing bash invocations with MSYS_NO_PATHCONV=1 to keep paths intact.

When should I not use this Skill?

Do not use it to edit existing skills — edit their SKILL.md directly. Do not use it to install skills written by others — those should be copied rather than symlinked, per the repository's threat model.