{"id":"d65ec381-9e73-42be-ba52-e7e18c73f6e7","shortId":"FKDFnV","kind":"skill","title":"descriptive-skill-surface-admission","tagline":"Use source-aware admission rules so trusted local skills can surface automatically while plugin or MCP-provided entries must supply explicit descriptive metadata.","description":"# SKILL: Descriptive Skill Surface Admission\n**Domain:** tool-design\n**Trigger:** Use when a command or skill catalog mixes trusted local sources with external providers and you need a predictable rule for which entries may appear without manual curation.\n**Source Pattern:** Distilled from reviewed command-surface, skill-discovery, and CLI capability implementations.\n\n## Core Method\nSplit listing admission into two lanes based on source trust. Automatically admit curated local sources such as bundled skills, project-local skills, or other maintained first-party directories because those entries can safely fall back to derived summaries when metadata is sparse. Require external or extensible sources such as plugins and MCP-provided entries to supply explicit human-readable description or trigger metadata before they appear in the user-facing surface. This keeps local discovery easy without letting opaque third-party items pollute the shared catalog.\n\n## Key Rules\n- Decide admission from both source and metadata quality; provenance alone is not enough for external ecosystems.\n- Maintain an allowlist for trusted local sources that may rely on derived descriptions instead of explicit descriptive fields.\n- Require plugin, marketplace, or MCP-provided entries to expose meaningful descriptive metadata before listing them.\n- Apply the admission filter only after excluding non-skill entries such as built-ins, disabled model-invocation commands, or non-prompt command types.\n- Keep the rule deterministic and source-specific so users can predict why one class of skills auto-surfaces while another stays hidden until documented.\n\n## Example Application\nIf you are building a terminal assistant that loads skills from a local skills folder, a bundled starter pack, and several third-party MCP servers, let the bundled and project-local skills appear immediately even when they only have a first-line summary. For the MCP and plugin sources, hide entries until they declare a proper description or a clear when to use sentence, so the skill picker stays understandable instead of filling with opaque names.\n\n## Anti-Patterns (What NOT to do)\n- Do not apply a single admission rule to every source; treating bundled local skills like untrusted plugins creates unnecessary friction, while treating plugins like curated local assets floods the surface with low-context entries.\n- Do not surface third-party commands solely because they exist; missing descriptive metadata makes the catalog noisy and forces the model to guess what each external entry does.","tags":["descriptive","skill","surface","admission","cskill","agents","ychampion","agent-skills","ai-agents","cli","coding-agents","context-engineering"],"capabilities":["skill","source-ychampion","skill-descriptive-skill-surface-admission","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/descriptive-skill-surface-admission","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 (2,565 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:48.149Z","embedding":null,"createdAt":"2026-04-18T22:20:16.424Z","updatedAt":"2026-04-22T06:56:48.149Z","lastSeenAt":"2026-04-22T06:56:48.149Z","tsv":"'admiss':5,10,35,88,181,232,376 'admit':97 'allowlist':198 'alon':189 'anoth':278 'anti':365 'anti-pattern':364 'appear':65,155,319 'appli':230,373 'applic':284 'asset':397 'assist':291 'auto':275 'auto-surfac':274 'automat':18,96 'awar':9 'back':122 'base':92 'build':288 'built':244 'built-in':243 'bundl':103,301,313,382 'capabl':82 'catalog':47,177,422 'class':271 'clear':347 'cli':81 'command':44,75,250,255,412 'command-surfac':74 'context':404 'core':84 'creat':388 'curat':68,98,395 'decid':180 'declar':341 'deriv':124,207 'descript':2,29,32,149,208,212,225,344,418 'descriptive-skill-surface-admiss':1 'design':39 'determinist':260 'directori':115 'disabl':246 'discoveri':79,165 'distil':71 'document':282 'domain':36 'easi':166 'ecosystem':195 'enough':192 'entri':25,63,118,142,221,240,338,405,433 'even':321 'everi':379 'exampl':283 'exclud':236 'exist':416 'explicit':28,145,211 'expos':223 'extens':133 'extern':53,131,194,432 'face':160 'fall':121 'field':213 'fill':360 'filter':233 'first':113,328 'first-lin':327 'first-parti':112 'flood':398 'folder':299 'forc':425 'friction':390 'guess':429 'hidden':280 'hide':337 'human':147 'human-read':146 'immedi':320 'implement':83 'in':245 'instead':209,358 'invoc':249 'item':173 'keep':163,257 'key':178 'lane':91 'let':168,311 'like':385,394 'line':329 'list':87,228 'load':293 'local':14,50,99,107,164,201,297,317,383,396 'low':403 'low-context':402 'maintain':111,196 'make':420 'manual':67 'marketplac':216 'may':64,204 'mcp':23,140,219,309,333 'mcp-provid':22,139,218 'meaning':224 'metadata':30,127,152,186,226,419 'method':85 'miss':417 'mix':48 'model':248,427 'model-invoc':247 'must':26 'name':363 'need':57 'noisi':423 'non':238,253 'non-prompt':252 'non-skil':237 'one':270 'opaqu':169,362 'pack':303 'parti':114,172,308,411 'pattern':70,366 'picker':355 'plugin':20,137,215,335,387,393 'pollut':174 'predict':59,268 'project':106,316 'project-loc':105,315 'prompt':254 'proper':343 'proven':188 'provid':24,54,141,220 'qualiti':187 'readabl':148 'reli':205 'requir':130,214 'review':73 'rule':11,60,179,259,377 'safe':120 'sentenc':351 'server':310 'sever':305 'share':176 'singl':375 'skill':3,15,31,33,46,78,104,108,239,273,294,298,318,354,384 'skill-descriptive-skill-surface-admission' 'skill-discoveri':77 'sole':413 'sourc':8,51,69,94,100,134,184,202,263,336,380 'source-awar':7 'source-specif':262 'source-ychampion' 'spars':129 'specif':264 'split':86 'starter':302 'stay':279,356 'summari':125,330 'suppli':27,144 'surfac':4,17,34,76,161,276,400,408 'termin':290 'third':171,307,410 'third-parti':170,306,409 'tool':38 'tool-design':37 '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':381,392 'trigger':40,151 'trust':13,49,95,200 'two':90 'type':256 'understand':357 'unnecessari':389 'untrust':386 'use':6,41,350 'user':159,266 'user-fac':158 'without':66,167","prices":[{"id":"f27a8da9-b7bd-4a69-a1de-2d795e10f5d1","listingId":"d65ec381-9e73-42be-ba52-e7e18c73f6e7","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:16.424Z"}],"sources":[{"listingId":"d65ec381-9e73-42be-ba52-e7e18c73f6e7","source":"github","sourceId":"ychampion/cskill-agents/descriptive-skill-surface-admission","sourceUrl":"https://github.com/ychampion/cskill-agents/tree/main/skills/descriptive-skill-surface-admission","isPrimary":false,"firstSeenAt":"2026-04-18T22:20:16.424Z","lastSeenAt":"2026-04-22T06:56:48.149Z"}],"details":{"listingId":"d65ec381-9e73-42be-ba52-e7e18c73f6e7","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"ychampion","slug":"descriptive-skill-surface-admission","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":"34f08f07457f7e6e1de5db316dbec763c192040b","skill_md_path":"skills/descriptive-skill-surface-admission/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/ychampion/cskill-agents/tree/main/skills/descriptive-skill-surface-admission"},"layout":"multi","source":"github","category":"cskill-agents","frontmatter":{"name":"descriptive-skill-surface-admission","description":"Use source-aware admission rules so trusted local skills can surface automatically while plugin or MCP-provided entries must supply explicit descriptive metadata."},"skills_sh_url":"https://skills.sh/ychampion/cskill-agents/descriptive-skill-surface-admission"},"updatedAt":"2026-04-22T06:56:48.149Z"}}