Skip to content

feat: add exec CLI subcommand + agent skill definition#33

Open
cablate wants to merge 4 commits intomainfrom
feat/exec-cli-agent-skill
Open

feat: add exec CLI subcommand + agent skill definition#33
cablate wants to merge 4 commits intomainfrom
feat/exec-cli-agent-skill

Conversation

@cablate
Copy link
Owner

@cablate cablate commented Mar 12, 2026

Summary

  • Add standalone exec <tool> [params] CLI subcommand — all 8 tools callable directly without running the MCP server
  • Add agent skill definition (skills/google-maps/) following agentskill-expertise design patterns (Progressive Disclosure, scenario-based description, principle-oriented)
  • Add 10 exec-mode test assertions to smoke test suite (74 total, 0 failures)

Usage

npx @cablate/mcp-google-map exec geocode '{"address":"Tokyo Tower"}'
npx @cablate/mcp-google-map exec search-places '{"query":"ramen in Tokyo"}'
npx @cablate/mcp-google-map exec directions '{"origin":"Tokyo Tower","destination":"Shibuya Station","mode":"transit"}'

Test plan

  • npm run build passes
  • npm test — 74 passed, 0 failed
  • exec mode: help, unknown tool error, geocode, reverse-geocode, search-places all verified
  • Server default command ($0) unaffected — existing MCP server startup works as before
  • CI passes with full E2E tests

🤖 Generated with Claude Code

cablate and others added 4 commits March 13, 2026 02:48
Add standalone `exec` mode so tools can be invoked directly without
running the MCP server — enabling use as an AI agent skill.

- Add `exec <tool> [params]` yargs subcommand with all 8 tools
- Add agent skill definition (skills/google-maps/) following
  agentskill-expertise design patterns
- Add exec mode tests (10 assertions) to smoke test suite
- Update README with CLI exec usage section
- Remove unused express/path imports from cli.ts

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…e review

- Shorten README CLI Exec Mode to essentials
- Move chaining patterns from SKILL.md to references/tools-api.md
- Add "When to Update" section to SKILL.md
- Add update trigger to description frontmatter

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add stdio: ['pipe', 'pipe', 'pipe'] to prevent child process stderr
from leaking into test output.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant