{"id":"39e799a7-f2c7-49a5-b619-f420eee2b2f6","shortId":"Qug8zR","kind":"skill","title":"file-todos","tagline":">-","description":"# File-based todo tracking\n\n## File naming convention\n\n```\n{issue_id}-{status}-{priority}-{description}.md\n```\n\n- **issue_id**: Sequential number (001, 002, 003...) -- never reused\n- **status**: `pending` (needs triage), `ready` (approved), `complete` (done)\n- **priority**: `p1` (critical), `p2` (important), `p3` (nice-to-have)\n- **description**: kebab-case, brief description\n\nExamples: `001-pending-p1-mailer-test.md`, `002-ready-p1-fix-n-plus-1.md`, `005-complete-p2-refactor-csv.md`\n\n## File Structure\n\nUse [todo-template.md](./assets/todo-template.md) as a starting point. YAML frontmatter:\n\n```yaml\n---\nstatus: ready              # pending | ready | complete\npriority: p1               # p1 | p2 | p3\nissue_id: \"002\"\ntags: [typescript, performance, database]\ndependencies: [\"001\"]      # Issue IDs this is blocked by\n---\n```\n\n**Required sections:** Problem Statement, Findings, Proposed Solutions, Recommended Action, Acceptance Criteria, Work Log\n\n**Optional sections:** Technical Details, Resources, Notes\n\n## Key Distinctions\n\n**File-todos system (this skill):** Markdown files in `todos/` directory for development/project tracking. Used by humans and agents.\n\n**Application Todo model:** Database model for user-facing task management. Different from this file-based system.\n\n**TodoWrite tool:** In-memory task tracking during agent sessions. Temporary, not persisted to disk.\n\n## References\n\n- [workflows.md](./references/workflows.md) - Creating, triaging, dependencies, work logs, completing todos, integration table\n- [quick-reference.md](./references/quick-reference.md) - Bash commands for finding work, dependencies, searching\n- [todo-template.md](./assets/todo-template.md) - Template for new todo files","tags":["file","todos","skills","iliaal","agent-skills","ai-coding-assistant","ai-tools","claude-code"],"capabilities":["skill","source-iliaal","skill-file-todos","topic-agent-skills","topic-ai-coding-assistant","topic-ai-tools","topic-claude-code","topic-skills"],"categories":["ai-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/iliaal/ai-skills/file-todos","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add iliaal/ai-skills","source_repo":"https://github.com/iliaal/ai-skills","install_from":"skills.sh"}},"qualityScore":"0.456","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 13 github stars · SKILL.md body (1,724 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-05-18T19:07:02.089Z","embedding":null,"createdAt":"2026-05-09T01:05:35.110Z","updatedAt":"2026-05-18T19:07:02.089Z","lastSeenAt":"2026-05-18T19:07:02.089Z","tsv":"'/assets/todo-template.md':59,187 '/references/quick-reference.md':178 '/references/workflows.md':167 '001':22,85 '001-pending-p1-mailer-test.md':52 '002':23,79 '002-ready-p1-fix-n-plus-1.md':53 '003':24 '005-complete-p2-refactor-csv.md':54 'accept':101 'action':100 'agent':131,158 'applic':132 'approv':32 'base':6,148 'bash':179 'block':90 'brief':49 'case':48 'command':180 'complet':33,71,173 'convent':11 'creat':168 'criteria':102 'critic':37 'databas':83,135 'depend':84,170,184 'descript':16,45,50 'detail':108 'development/project':125 'differ':143 'directori':123 'disk':164 'distinct':112 'done':34 'exampl':51 'face':140 'file':2,5,9,55,114,120,147,192 'file-bas':4,146 'file-todo':1,113 'find':96,182 'frontmatt':65 'human':129 'id':13,19,78,87 'import':39 'in-memori':152 'integr':175 'issu':12,18,77,86 'kebab':47 'kebab-cas':46 'key':111 'log':104,172 'manag':142 'markdown':119 'md':17 'memori':154 'model':134,136 'name':10 'need':29 'never':25 'new':190 'nice':42 'nice-to-hav':41 'note':110 'number':21 'option':105 'p1':36,73,74 'p2':38,75 'p3':40,76 'pend':28,69 'perform':82 'persist':162 'point':63 'prioriti':15,35,72 'problem':94 'propos':97 'quick-reference.md':177 'readi':31,68,70 'recommend':99 'refer':165 'requir':92 'resourc':109 'reus':26 'search':185 'section':93,106 'sequenti':20 'session':159 'skill':118 'skill-file-todos' 'solut':98 'source-iliaal' 'start':62 'statement':95 'status':14,27,67 'structur':56 'system':116,149 'tabl':176 'tag':80 'task':141,155 'technic':107 'templat':188 'temporari':160 'todo':3,7,115,122,133,174,191 'todo-template.md':58,186 'todowrit':150 'tool':151 'topic-agent-skills' 'topic-ai-coding-assistant' 'topic-ai-tools' 'topic-claude-code' 'topic-skills' 'track':8,126,156 'triag':30,169 'typescript':81 'use':57,127 'user':139 'user-fac':138 'work':103,171,183 'workflows.md':166 'yaml':64,66","prices":[{"id":"4bf7352a-cf67-498a-afde-88875bcaf52b","listingId":"39e799a7-f2c7-49a5-b619-f420eee2b2f6","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"iliaal","category":"ai-skills","install_from":"skills.sh"},"createdAt":"2026-05-09T01:05:35.110Z"}],"sources":[{"listingId":"39e799a7-f2c7-49a5-b619-f420eee2b2f6","source":"github","sourceId":"iliaal/ai-skills/file-todos","sourceUrl":"https://github.com/iliaal/ai-skills/tree/master/skills/file-todos","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:35.110Z","lastSeenAt":"2026-05-18T19:07:02.089Z"}],"details":{"listingId":"39e799a7-f2c7-49a5-b619-f420eee2b2f6","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"iliaal","slug":"file-todos","github":{"repo":"iliaal/ai-skills","stars":13,"topics":["agent-skills","ai-coding-assistant","ai-tools","claude-code","skills"],"license":"mit","html_url":"https://github.com/iliaal/ai-skills","pushed_at":"2026-05-16T13:15:17Z","description":"Curated collection of agent skills for AI coding assistants.","skill_md_sha":"0235e8b48119f48e1a684e8edb50e2d5fd7f2f5c","skill_md_path":"skills/file-todos/SKILL.md","default_branch":"master","skill_tree_url":"https://github.com/iliaal/ai-skills/tree/master/skills/file-todos"},"layout":"multi","source":"github","category":"ai-skills","frontmatter":{"name":"file-todos","description":">-"},"skills_sh_url":"https://skills.sh/iliaal/ai-skills/file-todos"},"updatedAt":"2026-05-18T19:07:02.089Z"}}