# Create Project Skill

> Scaffold a project-local skill under .agents/skills with contract and layout validation. Use when this capability is needed.

- Skill: `tomevault-io/create-project-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/create-project-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/create-project-skill/raw
- Safety review: pending
- 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-project-skill

---


# Create Project Skill

## Contract

Prereqs:

- Run inside a git work tree.
- `bash`, `git`, and `python3` available on `PATH`.
- Target project path is a git work tree where `.agents/skills/` can be created.

Inputs:

- Required:
  - `--skill-dir <.agents/skills/...|<skill-name>>`
- Optional:
  - `--project-path <path>` (defaults to current directory)
  - `--title "<Title>"` (defaults to Title Case from skill name)
  - `--description "<text>"` (defaults to `TBD`)

Outputs:

- Creates a project-local skill skeleton at `<project>/.agents/skills/...`:
  - `SKILL.md`
  - `scripts/<skill-name>.sh`
  - `tests/test_<skill_path>.sh`
- Validates generated contract headings using:
  - `$AGENT_HOME/skills/tools/skill-management/skill-governance/scripts/validate_skill_contracts.sh --file <SKILL.md>`
- Validates project-skill layout using an internal local validator.

Exit codes:

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

Failure modes:

- `--skill-dir` missing/invalid or outside `.agents/skills/`.
- Target project path missing, not a directory, or not a git work tree.
- Target skill directory already exists.
- Missing prerequisites (`git`, `python3`) or missing template/validator files.
- Generated skeleton fails contract or layout validation.

## Scripts (only entrypoints)

- `$AGENT_HOME/skills/tools/skill-management/create-project-skill/scripts/create_project_skill.sh`

## Workflow

1. Resolve the target project root (default current directory) and verify it is a git work tree.
2. Normalize `--skill-dir` to `.agents/skills/...` (supports shorthand `<skill-name>`).
   - If existing project skills share a prefix convention (for example `nils-cli-`), auto-apply that prefix to the new skill directory name.
3. Scaffold `SKILL.md`, a scripts entrypoint, and a tests smoke stub.
4. Run contract validation and local project-skill layout validation.
5. Return success output with the created project-skill path.

---
> 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 -->