[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7F6C40YCW0N1P9ENGE9WN50":3,"skill-same:01M7F6C40YCW0N1P9ENGE9WN50":71},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":28,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M7F6C40YCW0N1P9ENGE9WN50","design",null,"yigitkonur\u002Fplugin-agentic-maker","yigitkonur","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9989650?v=4","01M7548A59WS0A38NSK8FASK46","Yigit Konur","01M7F6AQQPM8KBP08NQ3BG7160",0,"MIT","https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fdesign\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: design\ndescription: Design an agent-facing CLI, MCP server or skill: choose the surface, interview, sketch before code. Started by you.\ndisable-model-invocation: true\nargument-hint: \"\u003Cwhat the agent should be able to do>\"\nallowed-tools: Bash(agentic-maker *) Bash(${CLAUDE_PLUGIN_ROOT}\u002Fbin\u002Fagentic-maker *) Read Grep Glob\n---\n\n# Design\n\n> In Codex: `$ARGUMENTS` is what the user wrote after the skill name. `${CLAUDE_PLUGIN_ROOT}` and `${CLAUDE_SKILL_DIR}` mean the plugin folder and this skill's folder (the plugin folder is two levels above this file); `agentic-maker` is on PATH or is `\u003Cplugin folder>\u002Fbin\u002Fagentic-maker`. A line that starts with an exclamation mark and a backtick is a command: run it yourself first.\n\nIdea: `$ARGUMENTS`\n\nReference files are under `${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fagent-interface-design\u002Freferences\u002F`; the interviews and workflows are in `${CLAUDE_SKILL_DIR}\u002Freferences\u002F`. This runs in the main conversation, so ask the user directly.\n\nExisting surfaces: !`${CLAUDE_PLUGIN_ROOT}\u002Fbin\u002Fagentic-maker detect \"${CLAUDE_PROJECT_DIR}\" --human 2>&1 | head -20 || true`\n\n## Procedure\n\n1. **Choose the surface first.** [surface-choice.md](..\u002Fagent-interface-design\u002Freferences\u002Fdecisions\u002Fsurface-choice.md): a CLI when a mature CLI exists or the agent works in a shell; an MCP server only for per-user auth or tenancy, approvals, typed remote discovery, a shared multi-client service or server-held state; a skill when the gap is workflow guidance; a hybrid when control and execution differ. Label each recommendation as documented fact, benchmark, or practitioner report. Fix an existing CLI before proposing an MCP server.\n2. **Interview.** Use the interview for the surface chosen in step 1, in its words, one group of up to four questions at a time: an MCP server, [interview-mcp.md](references\u002Finterview-mcp.md) (twelve questions); a CLI or script, [interview-cli.md](references\u002Finterview-cli.md); a skill, [interview-skill.md](references\u002Finterview-skill.md). The closed questions go through `AskUserQuestion` with the options the file lists; the open ones are asked as plain text, because that tool offers choices, not free text. Do not put an MCP question to someone designing a CLI or a skill. Stop and propose defaults when the user says \"whatever you think is best\", and get an explicit yes.\n3. **Sketch.** Start from the agent's task, then the smallest surface that serves it, then answer the eight contract questions ([contract.md](..\u002Fagent-interface-design\u002Freferences\u002Fcontract.md)). For a CLI: the deliverables in [cli-deliverables.md](references\u002Fcli-deliverables.md) (command grammar, flags, stdout\u002Fstderr rules, envelope, exit codes, migration notes). For an MCP server: [mcp-design-workflow.md](references\u002Fmcp-design-workflow.md) (architecture sketch, tool list with Verb + Resource names, schemas, error strategy, budget).\n4. **Approval gate.** Present the sketch and wait. Write no code until the user approves it; then build it with `\u002Fagentic-maker:build-cli`, `\u002Fagentic-maker:build-mcp` or `\u002Fagentic-maker:build-skill` (each probes what it builds and hands over the derail test), and `\u002Fagentic-maker:audit` and `\u002Fagentic-maker:derail` check it afterwards.\n\nIf a companion skill for the implementation is installed (the SDK builders are listed in [companion-routing.md](..\u002Fagent-interface-design\u002Freferences\u002Fdecisions\u002Fcompanion-routing.md)), name it; do not assume it is.\n","# Design\n\n> In Codex: `$ARGUMENTS` is what the user wrote after the skill name. `${CLAUDE_PLUGIN_ROOT}` and `${CLAUDE_SKILL_DIR}` mean the plugin folder and this skill's folder (the plugin folder is two levels above this file); `agentic-maker` is on PATH or is `\u003Cplugin folder>\u002Fbin\u002Fagentic-maker`. A line that starts with an exclamation mark and a backtick is a command: run it yourself first.\n\nIdea: `$ARGUMENTS`\n\nReference files are under `${CLAUDE_PLUGIN_ROOT}\u002Fskills\u002Fagent-interface-design\u002Freferences\u002F`; the interviews and workflows are in `${CLAUDE_SKILL_DIR}\u002Freferences\u002F`. This runs in the main conversation, so ask the user directly.\n\nExisting surfaces: !`${CLAUDE_PLUGIN_ROOT}\u002Fbin\u002Fagentic-maker detect \"${CLAUDE_PROJECT_DIR}\" --human 2>&1 | head -20 || true`\n\n## Procedure\n\n1. **Choose the surface first.** [surface-choice.md](..\u002Fagent-interface-design\u002Freferences\u002Fdecisions\u002Fsurface-choice.md): a CLI when a mature CLI exists or the agent works in a shell; an MCP server only for per-user auth or tenancy, approvals, typed remote discovery, a shared multi-client service or server-held state; a skill when the gap is workflow guidance; a hybrid when control and execution differ. Label each recommendation as documented fact, benchmark, or practitioner report. Fix an existing CLI before proposing an MCP server.\n2. **Interview.** Use the interview for the surface chosen in step 1, in its words, one group of up to four questions at a time: an MCP server, [interview-mcp.md](references\u002Finterview-mcp.md) (twelve questions); a CLI or script, [interview-cli.md](references\u002Finterview-cli.md); a skill, [interview-skill.md](references\u002Finterview-skill.md). The closed questions go through `AskUserQuestion` with the options the file lists; the open ones are asked as plain text, because that tool offers choices, not free text. Do not put an MCP question to someone designing a CLI or a skill. Stop and propose defaults when the user says \"whatever you think is best\", and get an explicit yes.\n3. **Sketch.** Start from the agent's task, then the smallest surface that serves it, then answer the eight contract questions ([contract.md](..\u002Fagent-interface-design\u002Freferences\u002Fcontract.md)). For a CLI: the deliverables in [cli-deliverables.md](references\u002Fcli-deliverables.md) (command grammar, flags, stdout\u002Fstderr rules, envelope, exit codes, migration notes). For an MCP server: [mcp-design-workflow.md](references\u002Fmcp-design-workflow.md) (architecture sketch, tool list with Verb + Resource names, schemas, error strategy, budget).\n4. **Approval gate.** Present the sketch and wait. Write no code until the user approves it; then build it with `\u002Fagentic-maker:build-cli`, `\u002Fagentic-maker:build-mcp` or `\u002Fagentic-maker:build-skill` (each probes what it builds and hands over the derail test), and `\u002Fagentic-maker:audit` and `\u002Fagentic-maker:derail` check it afterwards.\n\nIf a companion skill for the implementation is installed (the SDK builders are listed in [companion-routing.md](..\u002Fagent-interface-design\u002Freferences\u002Fdecisions\u002Fcompanion-routing.md)), name it; do not assume it is.\n",{},"main","4fbc0dad2dfb64cb1747e69933c261d941c8f074","skills\u002Fdesign","https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker","https:\u002F\u002Fgithub.com\u002Fyigitkonur","https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Fyigitkonur\u002F","HKEY_LOCAL_MACHINE","2026-10-26 07:52:56",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add yigitkonur\u002Fplugin-agentic-maker --skill design",{"tool":37,"command":38},"bunx","bunx skills add yigitkonur\u002Fplugin-agentic-maker --skill design",{"tool":40,"command":41},"pnpm","pnpm dlx skills add yigitkonur\u002Fplugin-agentic-maker --skill design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fdesign\u002FSKILL.md",true,[45,51,55,59,63,67],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",252,"https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fdesign\u002Fagents\u002Fopenai.yaml",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fcli-deliverables.md",1771,"https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fdesign\u002Freferences\u002Fcli-deliverables.md",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Finterview-cli.md",2358,"https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fdesign\u002Freferences\u002Finterview-cli.md",{"path":60,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Finterview-mcp.md",6824,"https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fdesign\u002Freferences\u002Finterview-mcp.md",{"path":64,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Finterview-skill.md",2253,"https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fdesign\u002Freferences\u002Finterview-skill.md",{"path":68,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Fmcp-design-workflow.md",3557,"https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fdesign\u002Freferences\u002Fmcp-design-workflow.md",[72,78,84,91,98,105],{"skillNo":73,"name":74,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M7F6C1RY3KEX7MZ34NF0SR2V","derailment-method","https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fderailment-method\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":18},"01M7F6BYP9843BZRKVG0K13HBK","targets","https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fderail\u002Freferences\u002Ftargets\u002Fskill.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":18},"01M7F6BTN9TZSN9QD6B5QG0JQD","derail","Test a skill, plugin, CLI or MCP tool with fresh agents and fix the text that misled them. Started by you; spends usage.","https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fderail\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":18},"01M7F6BPR2E18652MMHFJZ7F15","build-skill","Create, redesign or merge a skill, grounded in facts, then hand over the test. Started by you.","https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fbuild-skill\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":18},"01M7F6BK9QTJC0KR2GR6KGX4QQ","build-mcp","Build, extend or repair an MCP server for agents, probe it, hand over the test. Started by you.","https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fbuild-mcp\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":18},"01M7F6BGP7DJJ3HJ604SF207TZ","build-cli","Build or repair an agent-facing CLI, probe it, hand over the test. Started by you.","https:\u002F\u002Fgithub.com\u002Fyigitkonur\u002Fplugin-agentic-maker\u002Fblob\u002Fmain\u002Fskills\u002Fbuild-cli\u002FSKILL.md",[],[]]