Skip to content

feat(phase-2): agent surfaces — portable SKILL.md + MCP server#11

Merged
sonpiaz merged 2 commits into
mainfrom
feat/phase-2-agent-surfaces
May 19, 2026
Merged

feat(phase-2): agent surfaces — portable SKILL.md + MCP server#11
sonpiaz merged 2 commits into
mainfrom
feat/phase-2-agent-surfaces

Conversation

@sonpiaz
Copy link
Copy Markdown
Owner

@sonpiaz sonpiaz commented May 19, 2026

Summary

Implements Phase 2 of the defend-the-niche plan. Sub-spec docs landed in the preceding commit; this commit ships the implementations.

Locked pitch (grep-confirmation):

Watch any social video → get an architecture diagram, working component, runnable notebook, or step-by-step cheat sheet — automatically.

Items shipped

Item Where
Sub-spec — SKILL portable shape skills/SKILL-SPEC.md
Sub-spec — MCP stdio server mcp-server/SPEC.md
Portable SKILL.md (Claude Code + OpenClaw + Hermes) SKILL.md (repo root)
Symlink for back-compat skills/watch-cli/SKILL.md → ../../SKILL.md
MCP server package mcp-server/ (npm: @sonpiaz/watch-cli-mcp, not yet published)
install.sh --with-skill flag install.sh
install.sh --with-mcp flag (stub) install.sh
README install section update README.md

Reach

This PR makes watch-cli pickupable by:

  • Claude Code (SKILL.md drops into ~/.claude/skills/)
  • OpenClaw (SKILL.md drops into skills/)
  • hermes-agent (SKILL.md drops into optional-skills/research/)
  • 12+ MCP-capable agents (Claude Desktop, Cursor, Cline, Codex, Continue.dev, Windsurf, Zed, etc.) via the single MCP server

Punted

  • `npm publish` of @sonpiaz/watch-cli-mcp — package builds locally, ready to publish in a follow-up.
  • `--with-mcp` flag only prints a manual install hint until publish lands.

Test plan

  • SKILL.md YAML frontmatter validates
  • Symlink resolves
  • MCP server `npm install && npm run build` succeeds
  • MCP server starts in stdio mode
  • Phase 1 test suite still passes

Reviewer checklist

  • SKILL.md description is the locked pitch verbatim
  • MCP tool output JSON exactly matches docs/output-schema.md v1 shape
  • No emoji in SKILL.md or mcp-server/README.md (per BRANDING.md)
  • install.sh remains POSIX-bash compatible

sonpiaz and others added 2 commits May 19, 2026 13:03
Specs that govern the portable SKILL.md (Claude Code + OpenClaw +
hermes-agent) and the @sonpiaz/watch-cli-mcp stdio server. Both
documents are the contract Phase 2 implementation works against — no
authoring of the SKILL.md or server code yet. Locked package decision
for the MCP server: standalone npm package (option a). Error-code
mapping from CLI exit codes to MCP error codes documented, including
the partial-success rule that keeps exit 4 as MCP success at the
protocol layer.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- SKILL.md at repo root with frontmatter valid in Claude Code, OpenClaw, and hermes-agent
- skills/watch-cli/SKILL.md is now a symlink to the canonical root SKILL.md
- mcp-server/ package exposes a watch tool over MCP stdio (npm package @sonpiaz/watch-cli-mcp)
- install.sh gains --with-skill and --with-mcp flags
- README updated to document the new install flags

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@sonpiaz sonpiaz merged commit 6b91183 into main May 19, 2026
2 checks passed
@sonpiaz sonpiaz deleted the feat/phase-2-agent-surfaces branch May 19, 2026 20:15
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