skill-creator
Create or refactor Ship Faster-style skills (SKILL.md + references/ + scripts/). Use when adding a new skill, tightening trigger descriptions, splitting long docs into references, defining artifact-first I/O contracts, or packaging/validating a skill.
How do I install this agent skill?
npx skills add https://github.com/heyvhuang/ship-faster --skill skill-creatorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is a developer utility for managing and validating other skills. It uses secure YAML parsing and implements basic validation checks. It has a minor indirect prompt injection surface because it reads and summarizes content from other skill files to generate manifests and reports.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
11/11 files flagged
What does this agent skill do?
Skill Creator
Build skills that behave like “mini senior engineers”: trigger correctly, run deterministically, and leave resumable artifacts on disk.
What good looks like (Ship Faster standard)
SKILL.md: short and triggerable (routing + safety + I/O + output contract). Avoid long tutorials here.references/: deep docs loaded only when needed (progressive disclosure). Link directly fromSKILL.md.scripts/: deterministic helpers for repetitive/fragile work (prefer this over re-writing code in chat).assets/: templates or files to copy (not meant to be loaded into context).
Deep guidance:
- Progressive disclosure + authoring principles:
references/skill-design-principles.md - Workflow structure patterns:
workflows.md - Output templates/patterns:
output-patterns.md
Creation flow (recommended)
- Collect trigger examples (real user phrases that should activate the skill).
- Define the I/O contract (paths only) + required artifacts:
- What files does the skill read?
- What files must it write (plans, evidence, summaries)?
- Implement reusable resources first:
- add
scripts/for deterministic steps - add
references/for heavy documentation - add
assets/for templates / boilerplate
- add
- Write
SKILL.mdlast:- frontmatter
descriptionshould include trigger phrases - body should be short and link out to the resources above
- frontmatter
- Validate + package (optional) using the scripts below.
Scripts
All scripts live in scripts/ in this skill folder.
Initialize a new skill folder
python scripts/init_skill.py <skill-name> --path <output-directory>
Validate a skill (frontmatter + basic conventions)
python scripts/quick_validate.py /path/to/<skill-name>
Sync catalogs/assets (manifest, skills-map, docs catalog)
python scripts/sync_catalog.py
Lint skills (compat + quality gates)
python scripts/skill_lint.py --check-generated
Package a skill into a distributable .skill zip (optional)
python scripts/package_skill.py /path/to/<skill-name> [output-directory]
Notes for Ship Faster contributors
- Prefer prefix naming:
workflow-,tool-,review-,mcp-,skill-,publish-. - Keep side effects gated: write a plan first, ask for explicit confirmation, then execute, then verify.
- If you add/remove a skill, update the catalog:
skills/manifest.json.
Claude Code: Slash Commands merged into Skills
Claude Code now treats custom slash commands and skills as the same concept:
.claude/commands/<name>.mdand.claude/skills/<name>/SKILL.mdboth create/<name>- Existing
.claude/commands/files keep working (no migration required) - Prefer creating skills going forward so you can bundle
references/,scripts/, and use subagents
Useful frontmatter knobs (Claude Code):
disable-model-invocation: true- only user can invoke (good for side-effect workflows)user-invocable: false- hide from users; Claude-only background knowledgecontext: fork+agent: Explore|Plan|...- run skill in a subagent (good for research)allowed-tools- restrict tool surface when this skill is active
Archived full guide
The previous (long-form) version of this skill is preserved at:
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/heyvhuang/ship-faster/skill-creator">View skill-creator on skillZs</a>