{"id":"a6ea5f22-ca57-400d-a175-87c5819de9cc","shortId":"krtf37","kind":"skill","title":"note-improvement","tagline":"Capture an out-of-scope improvement opportunity so it doesn't get lost. Use when the user asks to \"note improvement\", \"save improvement\", \"track this for later\", \"remember this improvement\", \"note this idea\", \"log improvement\", \"backlog this\", or \"park this idea\". Also invoke pro","description":"# Note Improvement\n\nCapture improvement opportunities discovered during work so they don't get silently dropped. Appends to a project-level `.turbo/improvements.md` file that serves as a backlog of actionable ideas.\n\n## Step 1: Determine Project Root\n\nFind the nearest `.git` directory or project root. The improvements file lives at `.turbo/improvements.md` relative to the project root.\n\n## Step 2: Identify the Improvement\n\nGather from context or `$ARGUMENTS`:\n\n- **What**: One-line summary of the improvement\n- **Type**: One of `trivial`, `investigate`, or `standard` — see criteria below\n- **Category**: One of `refactor`, `performance`, `reliability`, `readability`, `testing`, `docs`, `dx` (developer experience), or `feature`\n- **Where**: File path(s) and/or area of the codebase affected\n- **Why**: Brief rationale — what's the benefit?\n\n### Type criteria\n\n- **trivial** — A direct fix: typo, rename, obvious one-liner, small localized cleanup with clear scope. No investigation or plan needed.\n- **investigate** — A symptom, not a fix: unclear root cause, performance question, intermittent bug, \"something feels off\". Needs dedicated root-cause analysis before any change.\n- **standard** — Everything else: clear-scope work that warrants planning (multi-file refactor, test additions, feature work).\n\nWhen the criteria above do not clearly select one value, use `AskUserQuestion` to confirm. Default to `standard` if the user declines to choose.\n\n## Step 3: Append to File\n\nRead `.turbo/improvements.md` if it exists. Create it with the header below if it doesn't.\n\n**File header** (only when creating new):\n\n```markdown\n# Improvements\n\nOut-of-scope improvement opportunities captured during work sessions. Review periodically and pull items into active work when appropriate.\n```\n\n**Entry format:**\n\n```markdown\n### <one-line summary>\n\n- **Type**: <trivial | investigate | standard>\n- **Category**: <category>\n- **Where**: `<file path or area>`\n- **Why**: <brief rationale>\n- **Noted**: <YYYY-MM-DD>\n```\n\nAppend the new entry at the end of the file.\n\n## Step 4: Confirm\n\nTell the user the improvement was noted and where the file is.\n\n## Rules\n\n- Do not duplicate — before appending, check if a similar improvement already exists. If it does, update the existing entry instead. If the existing entry predates the Type field, add a Type line while updating.\n- Keep entries concise — 3-5 lines max per entry. These are backlog items, not specs.\n- Do not act on the improvement — only record it. The user decides when to address it.\n- Do not create the `.turbo/` directory if the project doesn't have one — ask the user where to put the file instead.","tags":["note","improvement","turbo","tobihagemann","agent-skills","claude-code","claude-skills","developer-tools","skills"],"capabilities":["skill","source-tobihagemann","skill-note-improvement","topic-agent-skills","topic-claude-code","topic-claude-skills","topic-developer-tools","topic-skills"],"categories":["turbo"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/tobihagemann/turbo/note-improvement","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add tobihagemann/turbo","source_repo":"https://github.com/tobihagemann/turbo","install_from":"skills.sh"}},"qualityScore":"0.590","qualityRationale":"deterministic score 0.59 from registry signals: · indexed on github topic:agent-skills · 280 github stars · SKILL.md body (2,659 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T00:54:10.586Z","embedding":null,"createdAt":"2026-04-18T22:03:53.407Z","updatedAt":"2026-04-22T00:54:10.586Z","lastSeenAt":"2026-04-22T00:54:10.586Z","tsv":"'-5':375 '1':81 '2':105 '3':253,374 '4':322 'act':388 'action':78 'activ':296 'add':365 'addit':226 'address':400 'affect':155 'alreadi':347 'also':46 'analysi':207 'and/or':150 'append':64,254,311,341 'appropri':299 'area':151 'argument':113 'ask':22,415 'askuserquest':240 'backlog':40,76,382 'benefit':162 'brief':157 'bug':198 'captur':4,51,286 'categori':132,307 'caus':194,206 'chang':210 'check':342 'choos':251 'cleanup':177 'clear':179,215,235 'clear-scop':214 'codebas':154 'concis':373 'confirm':242,323 'context':111 'creat':262,276,404 'criteria':130,164,231 'decid':397 'declin':249 'dedic':203 'default':243 'determin':82 'develop':142 'direct':167 'directori':89,407 'discov':54 'doc':140 'doesn':14,270,411 'drop':63 'duplic':339 'dx':141 'els':213 'end':317 'entri':300,314,355,360,372,379 'everyth':212 'exist':261,348,354,359 'experi':143 'featur':145,227 'feel':200 'field':364 'file':71,95,147,223,256,272,320,334,422 'find':85 'fix':168,191 'format':301 'gather':109 'get':16,61 'git':88 'header':266,273 'idea':37,45,79 'identifi':106 'improv':3,10,25,27,34,39,50,52,94,108,121,279,284,328,346,391 'instead':356,423 'intermitt':197 'investig':126,182,186,305 'invok':47 'item':294,383 'keep':371 'later':31 'level':69 'line':117,368,376 'liner':174 'live':96 'local':176 'log':38 'lost':17 'markdown':278,302 'max':377 'multi':222 'multi-fil':221 'nearest':87 'need':185,202 'new':277,313 'note':2,24,35,49,310,330 'note-improv':1 'obvious':171 'one':116,123,133,173,237,414 'one-lin':115,172 'opportun':11,53,285 'out-of-scop':6,280 'park':43 'path':148 'per':378 'perform':136,195 'period':291 'plan':184,220 'predat':361 'pro':48 'project':68,83,91,102,410 'project-level':67 'pull':293 'put':420 'question':196 'rational':158 'read':257 'readabl':138 'record':393 'refactor':135,224 'relat':99 'reliabl':137 'rememb':32 'renam':170 'review':290 'root':84,92,103,193,205 'root-caus':204 'rule':336 'save':26 'scope':9,180,216,283 'see':129 'select':236 'serv':73 'session':289 'silent':62 'similar':345 'skill' 'skill-note-improvement' 'small':175 'someth':199 'source-tobihagemann' 'spec':385 'standard':128,211,245,306 'step':80,104,252,321 'summari':118 'symptom':188 'tell':324 'test':139,225 'topic-agent-skills' 'topic-claude-code' 'topic-claude-skills' 'topic-developer-tools' 'topic-skills' 'track':28 'trivial':125,165,304 'turbo':406 'turbo/improvements.md':70,98,258 'type':122,163,303,363,367 'typo':169 'unclear':192 'updat':352,370 'use':18,239 'user':21,248,326,396,417 'valu':238 'warrant':219 'work':56,217,228,288,297","prices":[{"id":"5a56926c-5fef-4690-95b2-00339d176082","listingId":"a6ea5f22-ca57-400d-a175-87c5819de9cc","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"tobihagemann","category":"turbo","install_from":"skills.sh"},"createdAt":"2026-04-18T22:03:53.407Z"}],"sources":[{"listingId":"a6ea5f22-ca57-400d-a175-87c5819de9cc","source":"github","sourceId":"tobihagemann/turbo/note-improvement","sourceUrl":"https://github.com/tobihagemann/turbo/tree/main/skills/note-improvement","isPrimary":false,"firstSeenAt":"2026-04-18T22:03:53.407Z","lastSeenAt":"2026-04-22T00:54:10.586Z"}],"details":{"listingId":"a6ea5f22-ca57-400d-a175-87c5819de9cc","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"tobihagemann","slug":"note-improvement","github":{"repo":"tobihagemann/turbo","stars":280,"topics":["agent-skills","claude-code","claude-skills","developer-tools","skills"],"license":"mit","html_url":"https://github.com/tobihagemann/turbo","pushed_at":"2026-04-21T12:22:12Z","description":"A composable dev process for Claude Code, packaged as modular skills.","skill_md_sha":"1d22f65a97b8ad469c0cd8434404cff47541afbc","skill_md_path":"skills/note-improvement/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/tobihagemann/turbo/tree/main/skills/note-improvement"},"layout":"multi","source":"github","category":"turbo","frontmatter":{"name":"note-improvement","description":"Capture an out-of-scope improvement opportunity so it doesn't get lost. Use when the user asks to \"note improvement\", \"save improvement\", \"track this for later\", \"remember this improvement\", \"note this idea\", \"log improvement\", \"backlog this\", or \"park this idea\". Also invoke proactively when noticing something improvable during work that falls outside the current task's scope — briefly mention it to the user and offer to note it."},"skills_sh_url":"https://skills.sh/tobihagemann/turbo/note-improvement"},"updatedAt":"2026-04-22T00:54:10.586Z"}}