baekenough/omcustom-takeover

Takeover Skill

Extract a canonical specification from an existing agent or skill file. Inspired by codespeak.dev's reverse compilation concept — deriving specs from existing implementations.

Purpose

When an agent or skill has evolved organically without a formal spec, takeover reverse-engineers a structured specification that captures its intent, invariants, workflow contract, and I/O contract.

Usage

/omcustom-takeover <agent-name>
/omcustom-takeover <skill-name>

Workflow

Phase 1: Read Target

1. Determine target type:
   - Agent: read .claude/agents/<name>.md
   - Skill: read .claude/skills/<name>/SKILL.md
2. Parse frontmatter (YAML metadata)
3. Parse body (markdown content)

Phase 2: Extract Spec Components

Extract these components from the target:

| Component | Source | Description | |-----------|--------|-------------| | intent | Description field + first paragraph | One-line purpose statement | | invariants | Rules referenced, constraints mentioned | Things that must always be true | | workflow_contract | Workflow/stages sections | Input → processing → output steps | | io_contract | Tools field, input/output patterns | What the agent consumes and produces | | dependencies | Skills field, guide references | External knowledge required | | boundaries | Limitations field, disallowedTools | What the agent explicitly cannot do |

Phase 3: Generate Spec

Output structured spec to .claude/specs/<name>.spec.md:

---
name: <name>
type: agent | skill
source: .claude/agents/<name>.md | .claude/skills/<name>/SKILL.md
generated: <ISO-8601 timestamp>
---

# Spec: <name>

## Intent
<one-line purpose>

## Invariants
- <rule or constraint that must always hold>
- ...

## Workflow Contract
### Input
<what the agent/skill receives>

### Processing
1. <step>
2. <step>

### Output
<what the agent/skill produces>

## I/O Contract
### Consumes
- Tools: [<tools used>]
- Files: [<files read>]
- MCP: [<MCP tools if any>]

### Produces
- Files: [<files created/modified>]
- Output: [<what is returned>]

## Dependencies
- Skills: [<referenced skills>]
- Guides: [<referenced guides>]
- Rules: [<rules enforced>]

## Boundaries
- <what the agent explicitly cannot do>

Phase 4: Report

[Done] Spec extracted: .claude/specs/<name>.spec.md
├── Intent: <summary>
├── Invariants: <count> rules
├── Workflow: <step count> steps
└── Dependencies: <count> refs

Notes

• Specs are git-untracked (under .claude/)
• Regenerate anytime with /omcustom-takeover <name>
• Used by /dev-refactor --spec for invariant-preserving refactoring
• Advisory output — human review recommended before using as contract