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 — claim your Tome and manage your conversions.