{"id":"da0fca32-5b0e-452c-ac25-5f2ce4c278da","shortId":"4dL6h8","kind":"skill","title":"portable-skill-loader-progressive-disclosure","tagline":"Keep the universal skill compact yet discoverable by loading minimal frontmatter first and heavy content on demand.","description":"# SKILL: Portable Skill Loader Progressive Disclosure\n**Domain:** skill-loading\n**Trigger:** Use when an agent must scan thousands of skills but only load detailed prompts for the handful that are actually invoked.\n**Source Pattern:** Distilled from reviewed command-surface, skill-discovery, and CLI capability implementations.\n\n## Core Method\nSeparate discovery from loading. During startup, scan only lightweight metadata such as the skill name, summary, trigger text, and file location to build a searchable index. Load the full instruction body only after the agent actually selects that skill, and cache the resolved metadata and file identities so repeated lookups stay cheap. Deduplicate by canonical path, and skip invalid or ignored skill directories without failing the whole scan.\n\n## Key Rules\n- Read only lightweight metadata during discovery; defer the full skill body until invocation time.\n- Resolve canonical paths so duplicate folders, symlinks, and mirrored mounts do not appear as separate skills.\n- Treat malformed frontmatter or missing files as warnings to skip, not as fatal startup errors.\n- Cache discovery results per source and invalidate them only when the relevant roots or settings change.\n\n## Example Application\nWhen building a CLI skill browser for a large monorepo, index every skill folder using only summary metadata at startup, then load the full instructions only for the skills the user or model actually opens.\n\n## Anti-Patterns (What NOT to do)\n- Don’t eagerly read every `SKILL.md` file during startup; that blocks discovery and may exceed token budgets.\n- Don’t treat invalid frontmatter as fatal—skip the skill instead of crashing.","tags":["portable","skill","loader","progressive","disclosure","cskill","agents","ychampion","agent-skills","ai-agents","cli","coding-agents"],"capabilities":["skill","source-ychampion","skill-portable-skill-loader-progressive-disclosure","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/portable-skill-loader-progressive-disclosure","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,677 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:56:53.999Z","embedding":null,"createdAt":"2026-04-18T22:20:56.416Z","updatedAt":"2026-04-22T00:56:53.999Z","lastSeenAt":"2026-04-22T00:56:53.999Z","tsv":"'actual':54,108,239 'agent':38,107 'anti':242 'anti-pattern':241 'appear':169 'applic':205 'block':258 'bodi':103,153 'browser':211 'budget':264 'build':95,207 'cach':113,188 'canon':127,158 'capabl':69 'chang':203 'cheap':124 'cli':68,209 'command':62 'command-surfac':61 'compact':11 'content':21 'core':71 'crash':277 'dedupl':125 'defer':149 'demand':23 'detail':47 'directori':135 'disclosur':6,29 'discover':13 'discoveri':66,74,148,189,259 'distil':58 'domain':30 'duplic':161 'eager':250 'error':187 'everi':217,252 'exampl':204 'exceed':262 'fail':137 'fatal':185,271 'file':92,118,178,254 'first':18 'folder':162,219 'frontmatt':17,175,269 'full':101,151,229 'hand':51 'heavi':20 'ident':119 'ignor':133 'implement':70 'index':98,216 'instead':275 'instruct':102,230 'invalid':131,194,268 'invoc':155 'invok':55 'keep':7 'key':141 'larg':214 'lightweight':81,145 'load':15,33,46,76,99,227 'loader':4,27 'locat':93 'lookup':122 'malform':174 'may':261 'metadata':82,116,146,223 'method':72 'minim':16 'mirror':165 'miss':177 'model':238 'monorepo':215 'mount':166 'must':39 'name':87 'open':240 'path':128,159 'pattern':57,243 'per':191 'portabl':2,25 'portable-skill-loader-progressive-disclosur':1 'progress':5,28 'prompt':48 'read':143,251 'relev':199 'repeat':121 'resolv':115,157 'result':190 'review':60 'root':200 'rule':142 'scan':40,79,140 'searchabl':97 'select':109 'separ':73,171 'set':202 'skill':3,10,24,26,32,43,65,86,111,134,152,172,210,218,234,274 'skill-discoveri':64 'skill-load':31 'skill-portable-skill-loader-progressive-disclosure' 'skill.md':253 'skip':130,182,272 'sourc':56,192 'source-ychampion' 'startup':78,186,225,256 'stay':123 'summari':88,222 'surfac':63 'symlink':163 'text':90 'thousand':41 'time':156 'token':263 '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' 'treat':173,267 'trigger':34,89 'univers':9 'use':35,220 'user':236 'warn':180 'whole':139 'without':136 'yet':12","prices":[{"id":"c9e8828a-10eb-4fca-8b03-64b332286ac8","listingId":"da0fca32-5b0e-452c-ac25-5f2ce4c278da","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:56.416Z"}],"sources":[{"listingId":"da0fca32-5b0e-452c-ac25-5f2ce4c278da","source":"github","sourceId":"ychampion/cskill-agents/portable-skill-loader-progressive-disclosure","sourceUrl":"https://github.com/ychampion/cskill-agents/tree/main/skills/portable-skill-loader-progressive-disclosure","isPrimary":false,"firstSeenAt":"2026-04-18T22:20:56.416Z","lastSeenAt":"2026-04-22T00:56:53.999Z"}],"details":{"listingId":"da0fca32-5b0e-452c-ac25-5f2ce4c278da","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"ychampion","slug":"portable-skill-loader-progressive-disclosure","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":"9bf28e23ed20064e20c0c6757d1697fd85058588","skill_md_path":"skills/portable-skill-loader-progressive-disclosure/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/ychampion/cskill-agents/tree/main/skills/portable-skill-loader-progressive-disclosure"},"layout":"multi","source":"github","category":"cskill-agents","frontmatter":{"name":"portable-skill-loader-progressive-disclosure","description":"Keep the universal skill compact yet discoverable by loading minimal frontmatter first and heavy content on demand."},"skills_sh_url":"https://skills.sh/ychampion/cskill-agents/portable-skill-loader-progressive-disclosure"},"updatedAt":"2026-04-22T00:56:53.999Z"}}