# Create Skill

> Scaffold a new skill directory that passes skill-governance audit and contract validation. Use when this capability is needed.

- Skill: `tomevault-io/create-skill-7` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/create-skill-7`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/create-skill-7/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/create-skill-7

---


# Create Skill

## Contract

Prereqs:

- Run inside a git work tree.
- `bash`, `git`, and `python3` available on `PATH`.

Inputs:

- Target directory via `--skill-dir` (must start with `skills/`).
- Optional metadata:
  - `--title` (defaults to Title Case derived from the directory name)
  - `--description` (defaults to `TBD`)

Outputs:

- A new skill skeleton under `--skill-dir`:
  - `SKILL.md`
  - `scripts/<skill-name>.sh`
  - `tests/test_<skill_path>.py`
- Root `README.md` updated with a new skill catalog row (for public domains: `workflows`, `tools`, `automation`).
- Runs skill-governance validators:
  - `$AGENT_HOME/skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh --file <SKILL.md>`
  - `$AGENT_HOME/skills/tools/skill-management/skill-governance/scripts/audit-skill-layout.sh --skill-dir <skill-dir>`

Exit codes:

- `0`: created + validated
- `1`: creation or validation failed
- `2`: usage error

Failure modes:

- `--skill-dir` invalid, already exists, or is outside `skills/`.
- Missing prerequisites (`git`, `python3`).
- Generated skeleton fails `skill-governance` validation.
- `README.md` update fails because required section/table structure is missing or malformed.

## Scripts (only entrypoints)

- `$AGENT_HOME/skills/tools/skill-management/create-skill/scripts/create_skill.sh`
- Legacy wrapper paths are not supported; keep docs and callers pinned to this script.

## Related docs

- Repo-wide review checklist:
  - `docs/runbooks/skills/SKILL_REVIEW_CHECKLIST.md`
- Baseline inventory format and current coverage snapshot:
  - `docs/plans/skills-inventory-audit.md`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/graysurf) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->