agentsclimarketplace
Sign in

Implementation notes

Skill to4iki/skills/engineering/implementation-notes

Implement a spec while keeping a running implementation-notes.html with decisions, deviations, tradeoffs, and open questions. Use for /implementation-notes, @implementation-notes, implementation-notes.html, or when the user wants a spec implemented with a work log.From its SKILL.md

Install
npx -y skills add to4iki/skills --skill implementation-notes

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.9 KB, 341 tokens by cl100k_base, as published. Nobody here has run it

Implementation Notes

Implement the spec and keep implementation-notes.html updated as you go so the user can follow how the implementation interprets, decides on, and diverges from the spec without reading every diff.

Invocation

/implementation-notes <SPEC>

<SPEC> is what to implement — a file path, URL, issue/PR reference, or inline requirements in the same message.

If the user invokes the skill without <SPEC>, ask what to implement before coding.

Notes file

  • Default: implementation-notes.html at the project root (self-contained; no external assets).
  • Purpose: leave a human-readable HTML file that lets the user review spec interpretation, implementation differences, and open questions.
  • Capture anything the implementation diverges from, interprets, or adds to the spec as notes the user should know about.

Capture as you work — not only at the end — especially:

  • Design decisions: choices you made where the spec was ambiguous
  • Deviations: places where you intentionally departed from the spec, and why
  • Tradeoffs: alternatives you considered and why you picked what you did
  • Open questions: anything you'd want the user to confirm or revise
  • Verification results (commands run and results)

Link to files; don't paste large code blocks.

HTML usage

Do not make implementation-notes.html a plain text document wrapped in HTML. Use HTML, CSS, SVG, and JavaScript when they make the notes easier to review.

Read references/html-output.md when detailed representation patterns are useful.

When done

Point the user to the notes file and call out open questions and verification results first.

What ships with it: 2 files

3.6 KB alongside SKILL.md

references/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.