capture-lede-decision

Record author ratings of merged pull request ledes into an event corpus.

1|1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/williamthorsen/codeassembly --skill capture-lede-decision-williamthorsen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: capture-lede-decision
Source: https://github.com/williamthorsen/codeassembly/tree/main/packages/agents/content/skills/capture-lede-decision
Command: npx skills add https://github.com/williamthorsen/codeassembly --skill capture-lede-decision-williamthorsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a pull request merges, there is no structured way to capture how good its lede (summary) actually was. This Skill records the author's rating of a merged PR's lede into the codeassembly event corpus, building a feedback dataset that shows what good ledes look like and where drafting guidance fails. ## Core Features & Use Cases - Guided rating capture: Presents the agent-written lede and the merged lede side by side, then asks the author for a five-level rating (poor through exemplary) with an optional free-text comment. - Automatic verdict derivation: Derives whether the lede was accepted or revised by comparing the two texts, and fingerprints the doctrine (entry-drafter and lede-cutter bodies) in force when the draft was written via a doctrine-hash. - Corpus integrity safeguards: Writes only author-given ratings, refuses unreachable or readonly stores, and supports PRs merged outside the normal merge flow via explicit lede files. - Use Case: After merging PR #142, invoke the skill to inspect the episode, review both ledes, rate the merged lede as "strong" with a comment, and write one tagged event record to the codeassembly store for later retrieval with kb-retrieve-events. ## Quick Start Ask the agent to record the lede decision for the pull request that just merged, then pick a rating when it shows you the agent and merged ledes.

Frequently Asked Questions about capture-lede-decision

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

FAQPage Schema
How do I record a rating for a merged pull request lede?

Invoke the skill after a merge; it inspects the ticket's artifact directory, shows the agent lede and merged lede, and asks for a rating from poor to exemplary. On your answer it pipes any comment to the helper, which writes one tagged event record to the codeassembly store.

What ratings can I give a merged lede?

Five levels are available: poor, adequate, good, strong, and exemplary. The verdict of accepted or revised is not asked; the helper derives it automatically from whether the agent's lede and the merged lede differ.

Can I record a lede decision for a PR merged outside the merge flow?

Yes. Extract the pull request body's What section into a file with gh pr view and awk, then pass it via --merged-lede-file. The helper records the file contents verbatim as the lede without applying its usual heading extraction.

What happens if I skip rating a merged lede?

Nothing is written. The corpus stores positive signals only, so declining to rate produces no record, and the absence of a record is never treated as an endorsement or a rating.

Why does capture-lede-decision fail with store-not-registered?

The codeassembly corpus must be registered in a kb.yaml file. If it is registered under a different name, re-run with --store <name>; if it is readonly or unreachable, the skill reports the problem and writes nothing.