note-it
Capture implementation notes after code implementation and review/fix. Records design decisions, deviations, tradeoffs, and open questions to docs/issue#XXXX.html. Triggers on: /note-it, 记录笔记, implementation notes.
npx skills add smallnest/goal-workflow --skill note-it --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Implementation Notes After completing implementation and review/fix for an Issue, capture a running implementation notes file that documents how the implementation diverges from or interprets the spec. ## Triggers Use when: - After `/goal` implementation and `/review-it` are both complete - User says "记录笔记", "implementation notes", "note-it", "/note-it" - Before `/ship-it` (as a final checkpoint) - Any time the user wants to capture design rationale ## The Job 1. Determine the Issue number from context (branch name, `/goal` target, or user input) 2. Review the implementation against the Issue spec / PRD 3. Generate an HTML notes file at `docs/issue#XXXX.html` 4. Present a summary to the user ## Notes Structure The HTML file must cover these four categories. If a category has nothing to report, write "None" with a brief explanation. ### 1. Design Decisions Choices made where the spec was ambiguous or silent: - What was the ambiguity? - What choice did you make? - What was the rationale? ### 2. Deviations Places where you intentionally departed from the spec: - What did the spec say? - What did you implement instead? - Why was the deviation necessary or better? ### 3. Tradeoffs Alt
- Triggers
- The Job
- Notes Structure
- 1. Design Decisions
- 2. Deviations
- 3. Tradeoffs
- 4. Open Questions
- Output
- HTML Template
- Example Item
- How to Determine the Issue Number
- Edge Cases
- Checklist
What does the note-it skill do?
Capture implementation notes after code implementation and review/fix. Records design decisions, deviations, tradeoffs, and open questions to docs/issue#XXXX.html. Triggers on: /note-it, 记录笔记, implementation notes.
How do I install it?
Run `npx skills add smallnest/goal-workflow --skill note-it --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From smallnest/goal-workflow, a repository with 199 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.