[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78F2R3YSVCGTZXMHAZKNQDZ":3,"skill-same:01M78F2R3YSVCGTZXMHAZKNQDZ":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":28,"ownerHtmlUrl":29,"ownerBlogUrl":6,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M78F2R3YSVCGTZXMHAZKNQDZ","api-local-test",null,"Locally test a backend API at runtime with mcp2cli — turn any OpenAPI, GraphQL, or MCP endpoint into a CLI (zero codegen, token-efficient). Use to smoke-test a running local server, exercise endpoints against acceptance criteria \u002F API contracts, and verify responses during Phase 7 integration tests and Phase 8 testing.","angpysha\u002Fapi2skill","angpysha","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F7025170?v=4","01M721R7EB17NTYWEFV7KW1B3Q","Andrii","01M78F2DTB4D5VB2WXKXBN0VFT",0,"MIT","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fapi-local-test\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: api-local-test\ndescription: >-\n  Locally test a backend API at runtime with mcp2cli — turn any OpenAPI, GraphQL, or MCP\n  endpoint into a CLI (zero codegen, token-efficient). Use to smoke-test a running local\n  server, exercise endpoints against acceptance criteria \u002F API contracts, and verify\n  responses during Phase 7 integration tests and Phase 8 testing.\ndisable-model-invocation: false\n---\n\n# api-local-test — local backend API testing with mcp2cli\n\n[**mcp2cli**](https:\u002F\u002Fgithub.com\u002Fknowsuchagency\u002Fmcp2cli) turns any **OpenAPI spec**, **GraphQL\nendpoint**, or **MCP server** into a CLI **at runtime** — no client codegen. It is the fastest\nway to exercise a **locally running backend** and assert responses, and it emits token-efficient\noutput (`--json` \u002F `--toon`) for agent consumption.\n\n> Use this to **test the API you just built or changed** against its contract and acceptance\n> criteria — not as a production client.\n\n---\n\n## Install (once per machine)\n\nRequires **uv** (Python). No project dependency added.\n\n```bash\nuvx mcp2cli --help              # run without installing\nuv tool install mcp2cli         # or install globally → `mcp2cli`\n```\n\n## Core workflow (local backend)\n\n1. **Start the local server** using the project's run command (stack-specific): e.g.\n   `dotnet run`, `npm run dev`, `uvicorn app:app --port 8000`, `flutter`\u002Femulator backend, etc.\n   Note the base URL (e.g. `http:\u002F\u002Flocalhost:8000`) and the spec\u002Fendpoint path.\n2. **Point mcp2cli at the local API** and list operations:\n\n```bash\n# OpenAPI (remote spec served by the app)\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --list\n\n# OpenAPI (local spec file + base URL)\nmcp2cli --spec .\u002Fopenapi.json --base-url http:\u002F\u002Flocalhost:8000 --list\n\n# GraphQL\nmcp2cli --graphql http:\u002F\u002Flocalhost:8000\u002Fgraphql --list\n\n# MCP server (HTTP\u002FSSE or stdio)\nmcp2cli --mcp http:\u002F\u002Flocalhost:8000\u002Fsse --list\nmcp2cli --mcp-stdio \"node server.js\" --list\n```\n\n3. **Call endpoints** and assert. Map each call to an **acceptance criterion** (`AC-N`) and, when\n   a contract exists, to the locked `operationId` \u002F GraphQL field \u002F RPC.\n\n```bash\n# GET with params\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json list-pets --status available\n\n# POST body from stdin\necho '{\"name\":\"Fido\",\"tag\":\"dog\"}' | mcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json create-pet --stdin\n\n# GraphQL query \u002F mutation\nmcp2cli --graphql http:\u002F\u002Flocalhost:8000\u002Fgraphql users --limit 10\nmcp2cli --graphql http:\u002F\u002Flocalhost:8000\u002Fgraphql create-user --name \"Alice\" --email \"alice@example.com\"\n```\n\n4. **Refresh the spec** after you change the API surface (specs are cached 1h):\n\n```bash\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --refresh --list\n```\n\n## Machine-readable output (for agents & assertions)\n\n```bash\n# Force valid JSON for every command (list + calls). MCP calls emit the full\n# CallToolResult envelope incl. structuredContent + isError.\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --json list-pets\n\n# TOON — token-efficient for large uniform arrays (40-60% fewer tokens than JSON)\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --toon list-records\n\n# Truncate large arrays; pipe to jq for assertions\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --json list-pets --head 5 | jq '.[].name'\n```\n\nPrefer `--json` for scripted checks and `--toon`\u002F`--head` when summarizing results in chat.\n\n## Bake a local profile (skip repeating flags)\n\n```bash\n# Save localhost connection + auth once\nmcp2cli bake create localapi --spec .\u002Fopenapi.json --base-url http:\u002F\u002Flocalhost:8000\n\n# Use with @ prefix\nmcp2cli @localapi --list\nmcp2cli @localapi list-pets --limit 10\nmcp2cli bake show localapi     # secrets masked\n```\n\nBaked configs live in `~\u002F.config\u002Fmcp2cli\u002Fbaked.json` (override `MCP2CLI_CONFIG_DIR`).\n\n## Auth & secrets (never pass secrets as bare args)\n\nUse `env:` \u002F `file:` prefixes so secrets don't appear in process listings, and OAuth for\nprotected APIs (tokens cached in `~\u002F.cache\u002Fmcp2cli\u002Foauth\u002F`).\n\n```bash\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json \\\n  --auth-header \"Authorization:env:LOCAL_API_TOKEN\" list-pets\n\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --oauth --list   # PKCE browser flow\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json \\\n  --oauth-client-id \"env:OAUTH_CLIENT_ID\" \\\n  --oauth-client-secret \"env:OAUTH_CLIENT_SECRET\" --list           # client credentials\n```\n\n**Never** hardcode tokens in commands, checkpoints, or reports.\n\n## Pipeline integration\n\n| Phase | Use |\n|-------|-----|\n| **7.6 Integration tests** (developer) | Smoke-test the changed endpoints against the local server before handoff; log calls run |\n| **8 Testing** (tester) | Exercise every AC against the running API; capture `--json` responses in the TEST report; map calls → `AC-N` |\n| **Design\u002FPlanning** | Cross-check the running API against the locked contract (`openapi-contract`, `graphql-contract`, `grpc-contract`) — the spec URL should match `artifacts\u002Fsdlc\u002Fapi\u002F` |\n\nComplements the **contract** skills: contracts define the *spec*, `api-local-test` verifies the\n*running implementation* matches it. Automated test suites (from the pack's `test.command`)\nremain the source of truth for the test gate; mcp2cli is for **fast, exploratory local\nverification** and agent-driven endpoint checks.\n\n## Degraded mode\n\nIf `mcp2cli` \u002F `uv` is unavailable, state **API-TEST DEGRADED** and fall back to `curl` \u002F\n`httpie` against the local base URL, keeping the same AC → call mapping.\n\n## Constraints\n\n- Test against a **local \u002F non-production** base URL unless the human explicitly approves otherwise.\n- No secrets in CLI args, chat, or reports — use `env:` \u002F `file:` \u002F `--oauth`.\n- Refresh the spec (`--refresh`) after changing the API surface.\n- Cite endpoint + status\u002Fshape in chat; save bulky responses to session artifacts, don't paste.\n","# api-local-test — local backend API testing with mcp2cli\n\n[**mcp2cli**](https:\u002F\u002Fgithub.com\u002Fknowsuchagency\u002Fmcp2cli) turns any **OpenAPI spec**, **GraphQL\nendpoint**, or **MCP server** into a CLI **at runtime** — no client codegen. It is the fastest\nway to exercise a **locally running backend** and assert responses, and it emits token-efficient\noutput (`--json` \u002F `--toon`) for agent consumption.\n\n> Use this to **test the API you just built or changed** against its contract and acceptance\n> criteria — not as a production client.\n\n---\n\n## Install (once per machine)\n\nRequires **uv** (Python). No project dependency added.\n\n```bash\nuvx mcp2cli --help              # run without installing\nuv tool install mcp2cli         # or install globally → `mcp2cli`\n```\n\n## Core workflow (local backend)\n\n1. **Start the local server** using the project's run command (stack-specific): e.g.\n   `dotnet run`, `npm run dev`, `uvicorn app:app --port 8000`, `flutter`\u002Femulator backend, etc.\n   Note the base URL (e.g. `http:\u002F\u002Flocalhost:8000`) and the spec\u002Fendpoint path.\n2. **Point mcp2cli at the local API** and list operations:\n\n```bash\n# OpenAPI (remote spec served by the app)\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --list\n\n# OpenAPI (local spec file + base URL)\nmcp2cli --spec .\u002Fopenapi.json --base-url http:\u002F\u002Flocalhost:8000 --list\n\n# GraphQL\nmcp2cli --graphql http:\u002F\u002Flocalhost:8000\u002Fgraphql --list\n\n# MCP server (HTTP\u002FSSE or stdio)\nmcp2cli --mcp http:\u002F\u002Flocalhost:8000\u002Fsse --list\nmcp2cli --mcp-stdio \"node server.js\" --list\n```\n\n3. **Call endpoints** and assert. Map each call to an **acceptance criterion** (`AC-N`) and, when\n   a contract exists, to the locked `operationId` \u002F GraphQL field \u002F RPC.\n\n```bash\n# GET with params\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json list-pets --status available\n\n# POST body from stdin\necho '{\"name\":\"Fido\",\"tag\":\"dog\"}' | mcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json create-pet --stdin\n\n# GraphQL query \u002F mutation\nmcp2cli --graphql http:\u002F\u002Flocalhost:8000\u002Fgraphql users --limit 10\nmcp2cli --graphql http:\u002F\u002Flocalhost:8000\u002Fgraphql create-user --name \"Alice\" --email \"alice@example.com\"\n```\n\n4. **Refresh the spec** after you change the API surface (specs are cached 1h):\n\n```bash\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --refresh --list\n```\n\n## Machine-readable output (for agents & assertions)\n\n```bash\n# Force valid JSON for every command (list + calls). MCP calls emit the full\n# CallToolResult envelope incl. structuredContent + isError.\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --json list-pets\n\n# TOON — token-efficient for large uniform arrays (40-60% fewer tokens than JSON)\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --toon list-records\n\n# Truncate large arrays; pipe to jq for assertions\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --json list-pets --head 5 | jq '.[].name'\n```\n\nPrefer `--json` for scripted checks and `--toon`\u002F`--head` when summarizing results in chat.\n\n## Bake a local profile (skip repeating flags)\n\n```bash\n# Save localhost connection + auth once\nmcp2cli bake create localapi --spec .\u002Fopenapi.json --base-url http:\u002F\u002Flocalhost:8000\n\n# Use with @ prefix\nmcp2cli @localapi --list\nmcp2cli @localapi list-pets --limit 10\nmcp2cli bake show localapi     # secrets masked\n```\n\nBaked configs live in `~\u002F.config\u002Fmcp2cli\u002Fbaked.json` (override `MCP2CLI_CONFIG_DIR`).\n\n## Auth & secrets (never pass secrets as bare args)\n\nUse `env:` \u002F `file:` prefixes so secrets don't appear in process listings, and OAuth for\nprotected APIs (tokens cached in `~\u002F.cache\u002Fmcp2cli\u002Foauth\u002F`).\n\n```bash\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json \\\n  --auth-header \"Authorization:env:LOCAL_API_TOKEN\" list-pets\n\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json --oauth --list   # PKCE browser flow\nmcp2cli --spec http:\u002F\u002Flocalhost:8000\u002Fopenapi.json \\\n  --oauth-client-id \"env:OAUTH_CLIENT_ID\" \\\n  --oauth-client-secret \"env:OAUTH_CLIENT_SECRET\" --list           # client credentials\n```\n\n**Never** hardcode tokens in commands, checkpoints, or reports.\n\n## Pipeline integration\n\n| Phase | Use |\n|-------|-----|\n| **7.6 Integration tests** (developer) | Smoke-test the changed endpoints against the local server before handoff; log calls run |\n| **8 Testing** (tester) | Exercise every AC against the running API; capture `--json` responses in the TEST report; map calls → `AC-N` |\n| **Design\u002FPlanning** | Cross-check the running API against the locked contract (`openapi-contract`, `graphql-contract`, `grpc-contract`) — the spec URL should match `artifacts\u002Fsdlc\u002Fapi\u002F` |\n\nComplements the **contract** skills: contracts define the *spec*, `api-local-test` verifies the\n*running implementation* matches it. Automated test suites (from the pack's `test.command`)\nremain the source of truth for the test gate; mcp2cli is for **fast, exploratory local\nverification** and agent-driven endpoint checks.\n\n## Degraded mode\n\nIf `mcp2cli` \u002F `uv` is unavailable, state **API-TEST DEGRADED** and fall back to `curl` \u002F\n`httpie` against the local base URL, keeping the same AC → call mapping.\n\n## Constraints\n\n- Test against a **local \u002F non-production** base URL unless the human explicitly approves otherwise.\n- No secrets in CLI args, chat, or reports — use `env:` \u002F `file:` \u002F `--oauth`.\n- Refresh the spec (`--refresh`) after changing the API surface.\n- Cite endpoint + status\u002Fshape in chat; save bulky responses to session artifacts, don't paste.\n",{"name":5,"description":7,"disable-model-invocation":20},"main","e2524bdd7bab86898b0f1d624b8152b4590a129b",".agents\u002Fskills\u002Fapi-local-test","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill","https:\u002F\u002Fwww.nuget.org\u002Fpackages\u002Fapi2skill","https:\u002F\u002Fgithub.com\u002Fangpysha",".NET Senior Software Engineer","2026-10-31 03:45:31",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add angpysha\u002Fapi2skill --skill api-local-test",{"tool":38,"command":39},"bunx","bunx skills add angpysha\u002Fapi2skill --skill api-local-test",{"tool":41,"command":42},"pnpm","pnpm dlx skills add angpysha\u002Fapi2skill --skill api-local-test","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fapi-local-test\u002FSKILL.md",true,[],[47,54,59,64,71,78],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M78F622M7F4WW0H07FTQBFM1","petstore","Call the Swagger Petstore API. A sample API that uses a petstore as an example to demonstrate api2skill.","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002Ftests\u002FApi2Skill.Tests\u002Ffixtures\u002F__approved__\u002Fpetstore-fsx\u002FSKILL.md",[],[],{"skillNo":55,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M78F5YMTHX818MXVCNZRSAGD","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002Ftests\u002FApi2Skill.Tests\u002Ffixtures\u002F__approved__\u002Fpetstore-csx\u002FSKILL.md",[],[],{"skillNo":60,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M78F5VTFF0CCN3VNVVWJ5N33","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002Ftests\u002FApi2Skill.Tests\u002Ffixtures\u002F__approved__\u002Fpetstore-cs\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M78F5PFP98A6RCB6TBB9RYTV","api2skill-creator","Interview the user about an OpenAPI\u002FSwagger API (including multi-spec, base URL, and authorization), assemble exact api2skill CLI commands, guide secrets.json setup, and migrate existing generated skills after api2skill upgrades (update \u002F regenerate \u002F merge). Prefer Plan mode for multi-spec interviews and migrations.","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002Fsrc\u002FApi2Skill\u002Ftemplates\u002Fapi2skill-creator\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":19},"01M78F5J49PSFJFDC003BHGYQM","speckit-taskstoissues","Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts.","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fspeckit-taskstoissues\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":19},"01M78F5EH1C32843TGS23BGCSB","speckit-tasks","Generate an actionable, dependency-ordered tasks.md for the feature based on available design artifacts.","https:\u002F\u002Fgithub.com\u002Fangpysha\u002Fapi2skill\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fspeckit-tasks\u002FSKILL.md",[],[]]