{"id":"edf4e131-aa98-4046-9ed3-e254068a4444","shortId":"S4DZkW","kind":"skill","title":"lazy-heavy-command-shims","tagline":"Stub heavy commands so the CLI stays light, loading the real implementation only when the command is executed.","description":"# SKILL: Lazy Heavy Command Shims\n**Domain:** Command Architecture  \n**Trigger:** Use when commands are structurally required in the registry but their modules are too heavy to import during startup.  \n**Source Pattern:** Distilled from reviewed command-surface and lazy-command delegation implementations.\n\n## Core Method\nDefine a minimal command descriptor that exposes the right name, description, and basic UX hints without importing the heavy implementation. When the user actually runs the command, dynamically import the real module and delegate execution to it. Keep the shim lightweight and transparent so the registry remains fast while the command still feels first-class when invoked.\n\n## Key Rules\n- Keep the stub command serializable (no large data or JSX imports) so the registry stays fast.\n- The stub’s execution path should dynamically import the heavy module and validate that the loaded command matches the expected shape before delegating.\n- Document that the stub’s `source` remains `'builtin'` or `'plugin'` so telemetry still recognizes it without bloating the module graph.\n- Use this shim pattern whenever a command’s source file is megabytes long or triggers long initialization.\n\n## Example Application\nIf an analytics or report command depends on a very large implementation file, register a small shim for discovery and help text, then import the full implementation only when the user invokes that command.\n\n## Anti-Patterns (What NOT to do)\n- Don’t import the heavy module at the top level and then forward to it; that defeats the shim’s purpose.\n- Don’t duplicate the heavy implementation inside the stub – keep the stub focused on delegation.\n- Don’t forget to guard `await import` with a type check (e.g., ensure `real.type === 'prompt'`) before calling `getPromptForCommand`.","tags":["lazy","heavy","command","shims","cskill","agents","ychampion","agent-skills","ai-agents","cli","coding-agents","context-engineering"],"capabilities":["skill","source-ychampion","skill-lazy-heavy-command-shims","topic-agent-skills","topic-ai-agents","topic-cli","topic-coding-agents","topic-context-engineering","topic-developer-tools","topic-mcp","topic-multi-agent","topic-terminal-ui"],"categories":["cskill-agents"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/ychampion/cskill-agents/lazy-heavy-command-shims","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add ychampion/cskill-agents","source_repo":"https://github.com/ychampion/cskill-agents","install_from":"skills.sh"}},"qualityScore":"0.467","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 34 github stars · SKILL.md body (1,811 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-22T06:56:50.029Z","embedding":null,"createdAt":"2026-04-18T22:20:34.136Z","updatedAt":"2026-04-22T06:56:50.029Z","lastSeenAt":"2026-04-22T06:56:50.029Z","tsv":"'actual':91 'analyt':208 'anti':241 'anti-pattern':240 'applic':205 'architectur':31 'await':288 'basic':80 'bloat':183 'builtin':174 'call':299 'check':293 'class':123 'cli':11 'command':4,8,21,27,30,35,58,63,71,94,118,131,160,193,211,239 'command-surfac':57 'core':66 'data':135 'defeat':263 'defin':68 'deleg':64,101,166,282 'depend':212 'descript':78 'descriptor':72 'discoveri':224 'distil':54 'document':167 'domain':29 'duplic':270 'dynam':95,150 'e.g':294 'ensur':295 'exampl':204 'execut':23,102,147 'expect':163 'expos':74 'fast':115,143 'feel':120 'file':196,218 'first':122 'first-class':121 'focus':280 'forget':285 'forward':259 'full':231 'getpromptforcommand':300 'graph':186 'guard':287 'heavi':3,7,26,47,86,153,251,272 'help':226 'hint':82 'implement':17,65,87,217,232,273 'import':49,84,96,138,151,229,249,289 'initi':203 'insid':274 'invok':125,237 'jsx':137 'keep':105,128,277 'key':126 'larg':134,216 'lazi':2,25,62 'lazy-command':61 'lazy-heavy-command-shim':1 'level':256 'light':13 'lightweight':108 'load':14,159 'long':199,202 'match':161 'megabyt':198 'method':67 'minim':70 'modul':44,99,154,185,252 'name':77 'path':148 'pattern':53,190,242 'plugin':176 'prompt':297 'purpos':267 'real':16,98 'real.type':296 'recogn':180 'regist':219 'registri':41,113,141 'remain':114,173 'report':210 'requir':38 'review':56 'right':76 'rule':127 'run':92 'serializ':132 'shape':164 'shim':5,28,107,189,222,265 'skill':24 'skill-lazy-heavy-command-shims' 'small':221 'sourc':52,172,195 'source-ychampion' 'startup':51 'stay':12,142 'still':119,179 'structur':37 'stub':6,130,145,170,276,279 'surfac':59 'telemetri':178 'text':227 'top':255 'topic-agent-skills' 'topic-ai-agents' 'topic-cli' 'topic-coding-agents' 'topic-context-engineering' 'topic-developer-tools' 'topic-mcp' 'topic-multi-agent' 'topic-terminal-ui' 'transpar':110 'trigger':32,201 'type':292 'use':33,187 'user':90,236 'ux':81 'valid':156 'whenev':191 'without':83,182","prices":[{"id":"7b78f12a-9df3-45fe-bece-4f6eb694e3bb","listingId":"edf4e131-aa98-4046-9ed3-e254068a4444","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"ychampion","category":"cskill-agents","install_from":"skills.sh"},"createdAt":"2026-04-18T22:20:34.136Z"}],"sources":[{"listingId":"edf4e131-aa98-4046-9ed3-e254068a4444","source":"github","sourceId":"ychampion/cskill-agents/lazy-heavy-command-shims","sourceUrl":"https://github.com/ychampion/cskill-agents/tree/main/skills/lazy-heavy-command-shims","isPrimary":false,"firstSeenAt":"2026-04-18T22:20:34.136Z","lastSeenAt":"2026-04-22T06:56:50.029Z"}],"details":{"listingId":"edf4e131-aa98-4046-9ed3-e254068a4444","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"ychampion","slug":"lazy-heavy-command-shims","github":{"repo":"ychampion/cskill-agents","stars":34,"topics":["agent-skills","ai-agents","cli","coding-agents","context-engineering","developer-tools","mcp","multi-agent","terminal-ui"],"license":"mit","html_url":"https://github.com/ychampion/cskill-agents","pushed_at":"2026-04-04T14:13:23Z","description":"Agent skills for coding CLIs, multi-agent runtimes, context engines, MCP extensions, and terminal tooling. Instead of using claude code's source code, give your agent skills to create your own!","skill_md_sha":"3a16cafcaeda73516d980fa6ab5ddd7962e83d8f","skill_md_path":"skills/lazy-heavy-command-shims/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/ychampion/cskill-agents/tree/main/skills/lazy-heavy-command-shims"},"layout":"multi","source":"github","category":"cskill-agents","frontmatter":{"name":"lazy-heavy-command-shims","description":"Stub heavy commands so the CLI stays light, loading the real implementation only when the command is executed."},"skills_sh_url":"https://skills.sh/ychampion/cskill-agents/lazy-heavy-command-shims"},"updatedAt":"2026-04-22T06:56:50.029Z"}}