01
Familiar visible outcome
A reviewable skill package containing a clear trigger, instructions, inputs, examples, failure rules, and an evaluation set.
02
Who it is for
People who have one unusually good AI result and want dependable reuse by themselves or a team.
03
Inputs
- A successful conversation you have the right to reuse
- The final artifact and the standard it met
- The human corrections that materially improved it
- A contrasting case where the method should not run
- Two synthetic test inputs
- The target agent environment and its permission model
04
Steps
Redact before analysis
Remove credentials, private names, customer data, paid-source passages, and unrelated personal context. Preserve the decisions, not the sensitive payload.
Reconstruct the successful method
Identify the trigger, required inputs, sequence, quality bar, tool calls, corrections, and stop conditions. Separate durable method from lucky wording.
Write the skill contract
State when to invoke it, when not to, what it may read or change, the artifact it returns, and the evidence required before completion.
Package progressive instructions
Keep the main instruction file navigable. Move detailed references and examples into named files only when the agent needs them.
Test fresh cases
Run a normal synthetic case, an incomplete-input case, and an out-of-scope case in a clean task. Compare artifacts, not the agent's confidence.
Adopt through the approved workflow
Review provenance, license, files, scripts, permissions, and target agents before installation. Packaging is not installation authority.
05
Tools
- A redaction pass
- A Markdown editor
- A skill-creation guide
- A clean agent task for evaluation
- Version control or a portable archive after approval
06
Human approval points
- Human confirms the source conversation may be reused
- Human approves the extracted method and examples
- Human reviews any scripts, external tools, and requested permissions
- Human authorizes installation separately for each target agent
07
Failure behavior
- If success depended on private context that cannot be packaged, produce a private note rather than a public skill
- If the trigger is vague, narrow it until a fresh agent can decide when to run the skill
- If one test case passes and another fails, keep the skill in draft and record the failing case
- If the package contains executable code, stop for a security and permission review before adoption
08
Verification checklist
- The package names its trigger, non-trigger, inputs, output, limits, and authority boundary
- No sensitive content remains in instructions, examples, filenames, or metadata
- A clean agent can follow the method without the original conversation
- Normal, incomplete, and out-of-scope cases behave as specified
- The artifact is materially consistent across at least two synthetic runs
- Provenance, license, version, and target environment are recorded
09
Copyable starter prompt
Extract a reusable skill from this successful AI conversation without copying accidental context. Conversation: [paste a redacted transcript] Successful artifact: [paste or describe] Why it was good: [observable criteria] Important human corrections: [list] Target agent: [environment] Authority boundary: [what it may read, write, or run] Return: trigger, non-trigger, required inputs, ordered method, output contract, tool and permission needs, failure rules, main skill instructions, supporting-file plan, and three synthetic evaluations. Distinguish durable method from one-off wording. Flag any private material or executable behavior that requires human review. Do not install the skill.
10
Worked synthetic example
Synthetic example
Scenario
A strong conversation repeatedly turned long meeting transcripts into concise decision records.
Input
Redacted transcript plus the human correction: decisions must be separated from discussion, and every owner must be explicit or marked unassigned.
Result
A Decision Record skill that triggers on meeting transcripts, produces Decisions, Owners, Deadlines, Evidence, Open Questions, and Unassigned Items, refuses to invent owners, and passes three synthetic transcript tests.
11