Skip to content
This repository was archived by the owner on Sep 30, 2026. It is now read-only.

feat: rewrite plugin as skill-based architecture for v2.0.0 - #22

Merged
garciasdos merged 6 commits into
mainfrom
chore/v2.0.0-skill-rewrite
Sep 19, 2026
Merged

garciasdos merged 6 commits into
mainfrom
chore/v2.0.0-skill-rewrite

Conversation

@vedkribhu

@vedkribhu vedkribhu commented Sep 18, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Replaces the command/agent-driven MCP workflow (setup, sync, search, test, mock, docs, security, learn, flows commands + readiness-analyzer agent) with 9 consolidated task-oriented skills: bootstrap, api-discovery, api-mocking, api-monitoring, api-testing, ci-integration, collection-schema-v3, performance-testing, postman-mcp-fallback.
  • Bumps .claude-plugin/plugin.json to 2.0.0 and syncs .mcp.json's X-Plugin-Version/User-Agent headers to match (per this repo's versioning convention).

Known gaps (not addressed in this PR)

  • .github/scripts/validate-structure.py still hard-requires commands/ and agents/ directories to exist — both are fully removed by this rewrite, so CI's Structure Integrity check will fail until that script is updated for the new skill-only architecture.
  • README.md, CHANGELOG.md, and CLAUDE.md still document the removed v1 commands/skills and have not been updated here — left for a follow-up since reconciling them is a judgment call on how the new architecture should be presented, not part of the source patch.

Test plan

  • Update validate-structure.py (or the workflow) to stop requiring commands//agents/ before merging, or confirm CI is expected to fail/be updated separately
  • Update README/CHANGELOG/CLAUDE.md to reflect the new skill set
  • Load the plugin locally (claude --plugin-dir .) and confirm the 9 new skills route correctly for representative prompts (bootstrap, mocking, monitoring, testing, discovery, CI, performance)

Generated with Claude Code

Replace the command/agent-driven MCP workflow (setup, sync, search, test,
mock, docs, security, learn, flows commands + readiness-analyzer agent)
with a consolidated set of task-oriented skills (bootstrap, api-discovery,
api-mocking, api-monitoring, api-testing, ci-integration,
collection-schema-v3, performance-testing, postman-mcp-fallback), and bump
plugin.json to 2.0.0. Syncs .mcp.json X-Plugin-Version/User-Agent headers
to 2.0.0 per the plugin's versioning convention.

Co-Authored-By: Claude <noreply@anthropic.com>
vedkribhu and others added 2 commits September 18, 2026 20:22
…wn lint

The v2.0.0 skill-based rewrite removes commands/ and agents/ entirely, but
validate-structure.py and validate-frontmatter.py still hard-required both
directories to exist. Make them optional (validated only if present) so a
skill-only plugin passes. Also fixes two real markdownlint violations in the
new skill files: missing blank lines around tables in
api-discovery/reference/search_filters.md (MD058), and multiple top-level
headings in bootstrap/SKILL.md (MD025).

Co-Authored-By: Claude <noreply@anthropic.com>
@garciasdos
garciasdos self-requested a review as a code owner September 18, 2026 17:38
garciasdos
garciasdos previously approved these changes Sep 18, 2026
@vedkribhu vedkribhu changed the title chore: rewrite plugin as skill-based architecture for v2.0.0 feat: rewrite plugin as skill-based architecture for v2.0.0 Sep 18, 2026
Adopt postman-plugin as source of truth for skill content: add the
ai-readiness and api-flows skills, replace postman-mcp-fallback with
postman-mcp-server's guidance-oriented rewrite (plus its references/),
and pull in the diverged bootstrap, ci-integration, and api-discovery
reference content.

Co-Authored-By: Claude <noreply@anthropic.com>
vedkribhu and others added 2 commits September 18, 2026 23:43
Matches the naming used for other single-concern skills; update the
bootstrap cross-reference to match.

Co-Authored-By: Claude <noreply@anthropic.com>
Collapse extra blank lines in ai-readiness, add blank lines around
tables in api-discovery's search_filters reference, and demote two
stray H1s in bootstrap back to H2 so there's a single top-level
heading per file.

Co-Authored-By: Claude <noreply@anthropic.com>
@garciasdos
garciasdos merged commit d7cb2d8 into main Sep 19, 2026
7 checks passed
@garciasdos
garciasdos deleted the chore/v2.0.0-skill-rewrite branch September 19, 2026 05:21
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants