okhp3-process-capture

OverKill Hill P³ · overkillhill.com · github.com/OKHP3

The intake mechanism. Turns "I just did this for the third time" into a structured artifact, not a lost observation.

Process

1. Extract the pattern. From the current conversation (or a description the user gives), identify: what was the task, what tools/skills were used, what was the input, what was the output, were there corrections or judgment calls along the way that would need to be encoded as instructions.

1. Assess readiness. Has this pattern stabilized enough to write down, or is this still "developing taste" (per the original delegation-contract framing — genuinely novel judgment calls each time means it's not a skill yet)?

• Not ready -> write a docs/BACKLOG.md entry (date, task, times observed, candidate family, status: captured). Stop here.
• Ready -> continue to step 3.

1. Determine target family. Does this fit an existing family (mermaid/, linkedin/, or this repo's own process-capture/), or does it need a new top-level family? If new, note this explicitly — adding a new family directory is a bigger decision than adding a skill within one, and the user should confirm.

1. Produce the skeleton. Frontmatter (name, "pushy" description per skill-creator's triggering guidance) + section-header outline matching the body's intended structure, with 1-2 sentence descriptions per section and pointers to reference files that will need authoring. Match the structure of existing skills in this repo (core+domain pattern for multi-skill families, single-skill pattern for self-contained ones).

1. Update the index. Add the new skill's trigger row to root AGENTS.md, even though the skeleton isn't fully authored yet — mark it in the "Planned" section if the body is still mostly TOC, move to "Active" once authored.

Handoff

A skeleton from this skill is a starting point for skill-creator (the Anthropic example skill, if available) for full authoring, testing, and description-optimization — this skill does intake and structure, not iteration and evals.

About

Built by Jamie Hill · OverKill Hill P³ Published at github.com/OKHP3 Part of the OKHP3/skillz Agent Skill library. MIT License -- free to use, fork, and adapt. A nod to the source is appreciated.