ot-create-skill

Author new agent skills or split oversized SKILL.md files into layered references.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/triage-software/skills --skill ot-create-skill-triage-software
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ot-create-skill
Source: https://github.com/triage-software/skills/tree/main/skills/ot-create-skill
Command: npx skills add https://github.com/triage-software/skills --skill ot-create-skill-triage-software

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams maintaining a collection of agent skills struggle to keep every SKILL.md consistent with house conventions: thin router bodies, layered references, lint-clean product-agnostic content, and behavior-preserving refactors. This Skill turns a brief into a convention-compliant skill, or conservatively splits an oversized SKILL.md, and refuses to hand back output that fails the lint and completeness gate. ## Core Features & Use Cases - Author mode: Runs a short interview (goal, trigger phrases, tracker interaction, chain membership), drafts a router-style SKILL.md from templates, scaffolds references/, and optionally a repo-local stub. - Split mode: Refactors an existing SKILL.md into references/ files word-for-word without changing behavior, refusing skills under ~150 lines or with no dominant template to extract. - Hard quality gate: Enforces scripts/lint.sh, split-mode completeness checks (no lost code blocks or lines, unchanged description, safety boundary loaded on every run), and a readability test before reporting. - Use Case: A maintainer says "create a skill for generating release notes" and receives a fully scaffolded skills/ot-release-notes/ directory with frontmatter, router body, references, and passing lint results. ## Quick Start Ask the agent to create a new skill from your brief, for example: use ot-create-skill to create a skill for triaging incoming bug reports.

Frequently Asked Questions about ot-create-skill

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

FAQPage Schema
How do I create a new agent skill from a brief?▼

Invoke the skill in author mode with a free-form description of what the skill should do. It interviews you about the goal, trigger phrases, tracker interaction, and chain membership, then scaffolds SKILL.md, references/, and an optional repo-local stub that passes the lint gate.

How to split a large SKILL.md into reference files?▼

Pass the existing skill's directory name to trigger split mode. The skill maps each section to a loading layer, moves text word-for-word into references/ files, leaves one-line pointers in the body, and verifies completeness so no content is lost.

When should I not split a SKILL.md file?▼

Do not split skills under roughly 150 lines, skills with no dominant template or conditional branch to extract, or fragments that load on every run anyway. The skill refuses these cases and explains why, since splitting only adds a load hop.

Does the split mode change the skill's routing description?▼

No. The frontmatter description is preserved byte-for-byte in split mode because it drives skill routing. The gate includes a diff check that fails if the description changed in any way.

What happens if the lint gate fails after generating a skill?▼

The skill fixes the reported violation and re-runs the gate until it passes. It never hands back a skill with failing lint, incomplete split content, or a body that no longer reads as a coherent recipe.