{"id":"333e4c1f-3fa2-4a82-ad3f-97e847055713","shortId":"HgvCX5","kind":"skill","title":"additive-agent-tool-surface-construction","tagline":"Merge agent-specific tool sets (MCP clients + fetched tools) into the parent context without disrupting the parent’s existing pool.","description":"# SKILL: Additive Agent Tool Surface Construction\n**Domain:** tool-surface\n**Trigger:** Use this when bringing tools from newly connected MCP servers into the agent’s tool pool while preserving the parent context.\n**Source Pattern:** Distilled from reviewed subagent orchestration, isolation, and lifecycle implementations.\n\n## Core Method\nWhen a child agent connects extra integrations, treat those capabilities as additions layered over the parent surface rather than as a replacement. Keep the parent client handles intact, append the agent-owned clients, and merge the newly discovered tool definitions alongside the inherited tool pool. Pass the merged clients, merged tools, and the child-owned cleanup handle downstream as one package so later stages can use the expanded surface without mutating the parent session.\n\n## Key Rules\n- Always start with parent clients and append agent clients in order to avoid losing existing handles that the session still needs.\n- Maintain agent tools separately so the agent can union them with the parent’s command/skill catalog without overwriting it.\n- Return both the merged clients and tools along with the cleanup closure so callers can pass them downstream transparently.\n- Log the before/after counts to aid debugging when tools disappear unexpectedly.\n\n## Example Application\nWhen a sub-agent launches with extra MCP servers, use this pattern so it keeps the parent integrations it inherited while also gaining the newly connected agent-specific tools.\n\n## Anti-Patterns (What NOT to do)\n- Don’t replace the parent client list with just the agent’s clients; that loses the original MCP endpoints.\n- Don’t forget to pass the merged tools through the helper that runs the forked agent, or the new MCP servers will appear to succeed but never expose their tools.","tags":["additive","agent","tool","surface","construction","cskill","agents","ychampion","agent-skills","ai-agents","cli","coding-agents"],"capabilities":["skill","source-ychampion","skill-additive-agent-tool-surface-construction","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/additive-agent-tool-surface-construction","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,810 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:44.378Z","embedding":null,"createdAt":"2026-04-18T22:19:39.866Z","updatedAt":"2026-04-22T06:56:44.378Z","lastSeenAt":"2026-04-22T06:56:44.378Z","tsv":"'addit':2,29,84 'additive-agent-tool-surface-construct':1 'agent':3,9,30,51,76,104,158,173,178,227,251,271,295 'agent-own':103 'agent-specif':8,250 'aid':215 'along':198 'alongsid':114 'also':245 'alway':151 'anti':255 'anti-pattern':254 'appear':302 'append':101,157 'applic':222 'avoid':163 'before/after':212 'bring':42 'caller':204 'capabl':82 'catalog':187 'child':75,128 'child-own':127 'cleanup':130,201 'client':14,98,106,122,155,159,195,266,273 'closur':202 'command/skill':186 'connect':46,77,249 'construct':6,33 'context':20,59 'core':71 'count':213 'debug':216 'definit':113 'disappear':219 'discov':111 'disrupt':22 'distil':62 'domain':34 'downstream':132,208 'endpoint':279 'exampl':221 'exist':26,165 'expand':142 'expos':307 'extra':78,230 'fetch':15 'forget':282 'fork':294 'gain':246 'handl':99,131,166 'helper':290 'implement':70 'inherit':116,243 'intact':100 'integr':79,241 'isol':67 'keep':95,238 'key':149 'later':137 'launch':228 'layer':85 'lifecycl':69 'list':267 'log':210 'lose':164,275 'maintain':172 'mcp':13,47,231,278,299 'merg':7,108,121,123,194,286 'method':72 'mutat':145 'need':171 'never':306 'new':298 'newli':45,110,248 'one':134 'orchestr':66 'order':161 'origin':277 'overwrit':189 'own':105,129 'packag':135 'parent':19,24,58,88,97,147,154,184,240,265 'pass':119,206,284 'pattern':61,235,256 'pool':27,54,118 'preserv':56 'rather':90 'replac':94,263 'return':191 'review':64 'rule':150 'run':292 'separ':175 'server':48,232,300 'session':148,169 'set':12 'skill':28 'skill-additive-agent-tool-surface-construction' 'sourc':60 'source-ychampion' 'specif':10,252 'stage':138 'start':152 'still':170 'sub':226 'sub-ag':225 'subag':65 'succeed':304 'surfac':5,32,37,89,143 'tool':4,11,16,31,36,43,53,112,117,124,174,197,218,253,287,309 'tool-surfac':35 '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':209 'treat':80 'trigger':38 'unexpect':220 'union':180 'use':39,140,233 'without':21,144,188","prices":[{"id":"b2ed361e-23fb-443c-96e6-56ecfceb220f","listingId":"333e4c1f-3fa2-4a82-ad3f-97e847055713","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:19:39.866Z"}],"sources":[{"listingId":"333e4c1f-3fa2-4a82-ad3f-97e847055713","source":"github","sourceId":"ychampion/cskill-agents/additive-agent-tool-surface-construction","sourceUrl":"https://github.com/ychampion/cskill-agents/tree/main/skills/additive-agent-tool-surface-construction","isPrimary":false,"firstSeenAt":"2026-04-18T22:19:39.866Z","lastSeenAt":"2026-04-22T06:56:44.378Z"}],"details":{"listingId":"333e4c1f-3fa2-4a82-ad3f-97e847055713","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"ychampion","slug":"additive-agent-tool-surface-construction","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":"d0c0c72566e84eba0cbd4e5476b7601bb36701cd","skill_md_path":"skills/additive-agent-tool-surface-construction/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/ychampion/cskill-agents/tree/main/skills/additive-agent-tool-surface-construction"},"layout":"multi","source":"github","category":"cskill-agents","frontmatter":{"name":"additive-agent-tool-surface-construction","description":"Merge agent-specific tool sets (MCP clients + fetched tools) into the parent context without disrupting the parent’s existing pool."},"skills_sh_url":"https://skills.sh/ychampion/cskill-agents/additive-agent-tool-surface-construction"},"updatedAt":"2026-04-22T06:56:44.378Z"}}