{"id":"7418cdcf-6df7-4d79-8c1e-31c76b59a009","shortId":"ZC9jxN","kind":"skill","title":"using-mint","tagline":"ALWAYS LOAD THIS SKILL. Required at conversation start for any project using mint. Establishes that the mint skill MUST be invoked before ANY file modification — features, bugs, refactors, configs, tests, docs. You cannot use Write/Edit tools without invoking mint first. Load thi","description":"<MANDATORY-RULE>\nFor ANY task that writes, edits, or deletes files — invoke `mint` FIRST.\n\nThis includes:\n- Features (any size)\n- Bug fixes (any size)\n- Refactors\n- Config changes\n- Documentation updates (if modifying .md files)\n- Test additions/changes\n- Dependency updates\n\nYou CANNOT use Write, Edit, or Bash (for file ops) tools until mint is invoked.\n</MANDATORY-RULE>\n\n# Using mint\n\n## The Rule\n\n**Invoke mint BEFORE modifying any file.** mint auto-routes to the right mode based on task complexity. You do not decide the workflow — mint does.\n\n## How to Invoke\n\nUse the `Skill` tool to invoke `mint` with the user's task description. mint will:\n- Auto-detect the right mode (quick, plan, research, ship, verify)\n- Announce the routing decision\n- Execute with quality gates, reviews, and disciplined delegation\n\n## When mint Applies\n\n| Task | Use mint? |\n|------|-----------|\n| Feature implementation | YES — plan or ship mode |\n| Bug fix | YES — quick or plan mode |\n| Refactor | YES — plan mode |\n| Config change (≤3 files) | YES — quick mode |\n| Research / investigation | YES — research mode |\n| Check quality gates | YES — verify mode |\n| ANY file modification | YES — always |\n| Pure conversation / questions | No |\n| Reading files for context | No |\n\n## Red Flags\n\nThese thoughts mean STOP — you're about to skip mint:\n\n| Thought | Reality |\n|---------|---------|\n| \"This is just a small fix\" | Small fixes use quick mode. Invoke mint. |\n| \"I'll just edit this one file\" | mint enforces gates even on single files. Invoke mint. |\n| \"Let me code first, review later\" | mint reviews during execution, not after. Invoke mint. |\n| \"This doesn't need planning\" | mint decides that, not you. Invoke mint. |\n| \"I know what to do\" | Knowing what ≠ disciplined execution. Invoke mint. |\n| \"I'll use Write/Edit directly\" | NO. Invoke mint first. Always. |\n\n## What mint Provides\n\n- **Auto-routing** — quick/plan/research/ship/verify based on complexity\n- **Quality gates** — lint + types + tests enforced before every commit\n- **Multi-stage review** — spec review → parallel audit (quality, security, conventions, tests, business)\n- **Learning loop** — past failures become future prevention via issues.md\n- **Plugin system** — stack, PM, design, and memory integrations\n- **Context protection** — main context stays clean, all heavy work delegated to subagents\n\n## Configuration\n\nmint expects `.mint/config.json` in the project root. If it doesn't exist, mint will prompt to run init.\n\n## Override\n\nThe user can always override mint's routing:\n- \"No, just quick-fix it\" → switches to quick mode\n- \"Actually plan this out\" → switches to plan mode\n- \"Skip mint, just do X\" → respect the override, but warn about skipped gates","tags":["using","mint","3li7alaki","agent-skills","agentic-workflow","agents","claude-code","development"],"capabilities":["skill","source-3li7alaki","skill-using-mint","topic-agent-skills","topic-agentic-workflow","topic-agents","topic-claude-code","topic-development"],"categories":["mint"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/3li7alaki/mint/using-mint","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add 3li7alaki/mint","source_repo":"https://github.com/3li7alaki/mint","install_from":"skills.sh"}},"qualityScore":"0.455","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 10 github stars · SKILL.md body (2,727 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:08:20.690Z","embedding":null,"createdAt":"2026-05-18T13:13:49.410Z","updatedAt":"2026-05-18T19:08:20.690Z","lastSeenAt":"2026-05-18T19:08:20.690Z","tsv":"'3':192 'actual':411 'additions/changes':77 'alway':4,212,311,396 'announc':154 'appli':168 'audit':338 'auto':107,144,316 'auto-detect':143 'auto-rout':106,315 'base':113,319 'bash':86 'becom':348 'bug':30,63,179 'busi':343 'cannot':36,81 'chang':69,191 'check':202 'clean':366 'code':267 'commit':330 'complex':116,321 'config':32,68,190 'configur':373 'context':220,361,364 'convent':341 'convers':10,214 'decid':120,285 'decis':157 'deleg':165,370 'delet':53 'depend':78 'descript':140 'design':357 'detect':145 'direct':306 'disciplin':164,298 'doc':34 'document':70 'doesn':280,383 'edit':51,84,252 'enforc':257,327 'establish':17 'even':259 'everi':329 'execut':158,274,299 'exist':385 'expect':375 'failur':347 'featur':29,60,172 'file':27,54,75,88,104,193,209,218,255,262 'first':43,57,268,310 'fix':64,180,241,243,405 'flag':223 'futur':349 'gate':161,204,258,323,431 'heavi':368 'implement':173 'includ':59 'init':391 'integr':360 'investig':198 'invok':24,41,55,94,99,127,133,247,263,277,289,300,308 'issues.md':352 'know':292,296 'later':270 'learn':344 'let':265 'lint':324 'll':250,303 'load':5,44 'loop':345 'main':363 'md':74 'mean':226 'memori':359 'mint':3,16,20,42,56,92,96,100,105,123,134,141,167,171,233,248,256,264,271,278,284,290,301,309,313,374,386,398,420 'mint/config.json':376 'mode':112,148,178,185,189,196,201,207,246,410,418 'modif':28,210 'modifi':73,102 'multi':332 'multi-stag':331 'must':22 'need':282 'one':254 'op':89 'overrid':392,397,426 'parallel':337 'past':346 'plan':150,175,184,188,283,412,417 'plugin':353 'pm':356 'prevent':350 'project':14,379 'prompt':388 'protect':362 'provid':314 'pure':213 'qualiti':160,203,322,339 'question':215 'quick':149,182,195,245,404,409 'quick-fix':403 'quick/plan/research/ship/verify':318 're':229 'read':217 'realiti':235 'red':222 'refactor':31,67,186 'requir':8 'research':151,197,200 'respect':424 'review':162,269,272,334,336 'right':111,147 'root':380 'rout':108,156,317,400 'rule':98 'run':390 'secur':340 'ship':152,177 'singl':261 'size':62,66 'skill':7,21,130 'skill-using-mint' 'skip':232,419,430 'small':240,242 'source-3li7alaki' 'spec':335 'stack':355 'stage':333 'start':11 'stay':365 'stop':227 'subag':372 'switch':407,415 'system':354 'task':48,115,139,169 'test':33,76,326,342 'thi':45 'thought':225,234 'tool':39,90,131 'topic-agent-skills' 'topic-agentic-workflow' 'topic-agents' 'topic-claude-code' 'topic-development' 'type':325 'updat':71,79 'use':2,15,37,82,95,128,170,244,304 'user':137,394 'using-mint':1 'verifi':153,206 'via':351 'warn':428 'without':40 'work':369 'workflow':122 'write':50,83 'write/edit':38,305 'x':423 'yes':174,181,187,194,199,205,211","prices":[{"id":"4c856cef-969a-4017-be2e-230f8fed247a","listingId":"7418cdcf-6df7-4d79-8c1e-31c76b59a009","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"3li7alaki","category":"mint","install_from":"skills.sh"},"createdAt":"2026-05-18T13:13:49.410Z"}],"sources":[{"listingId":"7418cdcf-6df7-4d79-8c1e-31c76b59a009","source":"github","sourceId":"3li7alaki/mint/using-mint","sourceUrl":"https://github.com/3li7alaki/mint/tree/main/skills/using-mint","isPrimary":false,"firstSeenAt":"2026-05-18T13:13:49.410Z","lastSeenAt":"2026-05-18T19:08:20.690Z"}],"details":{"listingId":"7418cdcf-6df7-4d79-8c1e-31c76b59a009","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"3li7alaki","slug":"using-mint","github":{"repo":"3li7alaki/mint","stars":10,"topics":["agent-skills","agentic-workflow","agents","ai","claude-code","development"],"license":"mit","html_url":"https://github.com/3li7alaki/mint","pushed_at":"2026-04-19T11:02:49Z","description":"Disciplined agentic development for Claude Code.","skill_md_sha":"ae0e1ca2150422fad3901e1eb6d1fd11a548fa33","skill_md_path":"skills/using-mint/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/3li7alaki/mint/tree/main/skills/using-mint"},"layout":"multi","source":"github","category":"mint","frontmatter":{"name":"using-mint","description":"ALWAYS LOAD THIS SKILL. Required at conversation start for any project using mint. Establishes that the mint skill MUST be invoked before ANY file modification — features, bugs, refactors, configs, tests, docs. You cannot use Write/Edit tools without invoking mint first. Load this skill when you see .mint/ directory in a project."},"skills_sh_url":"https://skills.sh/3li7alaki/mint/using-mint"},"updatedAt":"2026-05-18T19:08:20.690Z"}}