skills/pins/SKILL.md
Use when the user mentions pins or when context lookup or knowledge pinning is needed — entry point for the on-discovery pinning system.
npx skillsauth add toongri/oh-my-toong-playground pinsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
A pin is indexing, not a wiki. The SSOT lives in another system; a pin is just a pointer + surrounding context + cross-link.
| Slug | Proposition |
|---|---|
| indexing-not-wiki | A pin indexes the SSOT — do not restate SSOT content. |
| ssot-no-copy | Do not copy the SSOT body into the pin. Recording source_url and authority is sufficient. |
| 5-elements-only | Capture exactly five things: location, authority, one-line summary, surrounding context, cross-link. |
| long-body-wrong-ssot | A long pin body signals the SSOT is in the wrong place — move the SSOT and shrink the pin. |
select-pin — read existing pins. Invoke first when context is needed.write-pin — emit a new pin on discovery or update.The pin-session-start hook auto-surfaces the $OMT_DIR/pins/ index at SessionStart.
Emit immediately on discovery. Do not defer based on "might change later" — emit now and let a future discovery overwrite if needed. For Scenario F (no external SSOT exists), the "immediate" emit is step ③ of: ① propose external registration → ② register together → ③ emit pin. See write-pin/reference/use-cases.md.
Cross-cutting infrastructure. Does not place responsibilities on prometheus / sisyphus / spec / sisyphus-junior.
tools
Use at the end of a work session to review the WHOLE session and record entities worth pinning. This is the manual, deliberate complete-sweep review — NOT an automated nudge. Triggers on "wrap up", "wrap-up", "session wrap", "end of session", "what should I pin".
documentation
Use when initializing the pins knowledge graph for the first time in a project. Guides the user through creating pins.yaml (the storage manifest). Triggers on "setup pins", "initialize pins", "create pins.yaml", "first-run pins".
testing
Use when you need to record a single pin entity to the knowledge graph. Invokes lib/pins record() to validate and write a canonical .md file. Triggers on "record pin", "pin this", "save this as a pin".
databases
Use when looking up pins by type, tags, or source. Drives lib/pins/query.ts to retrieve matching pin entries from the knowledge graph. Supersedes the legacy manual ls+frontmatter procedure.