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

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "postman",
-  "version": "1.3.1",
+  "version": "2.0.0",
   "description": "Full API lifecycle management for Claude Code. Sync collections, generate client code, discover APIs, run tests, create mocks, publish docs, and audit security. Powered by the Postman MCP Server.",
   "author": {
     "name": "Postman",
@@ -19,6 +19,11 @@
     "documentation",
     "security",
     "openapi",
-    "agent-ready"
+    "agent-ready",
+    "mocking",
+    "monitoring",
+    "ci",
+    "ai-readiness",
+    "flows"
   ]
 }

.github/scripts/validate-frontmatter.py

@@ -39,7 +39,8 @@ def validate_commands(root: Path) -> list[str]:
     errors = []
     commands_dir = root / "commands"
     if not commands_dir.is_dir():
-        return [f"{commands_dir}: Directory not found"]
+        # commands/ is optional — a plugin may be skill-only
+        return errors
 
     for f in sorted(commands_dir.glob("*.md")):
         text = f.read_text()
@@ -88,7 +89,8 @@ def validate_agents(root: Path) -> list[str]:
     errors = []
     agents_dir = root / "agents"
     if not agents_dir.is_dir():
-        return [f"{agents_dir}: Directory not found"]
+        # agents/ is optional — a plugin may be skill-only
+        return errors
 
     required_fields = ["name", "description", "model", "allowed-tools"]
 

.github/scripts/validate-structure.py

@@ -33,17 +33,14 @@ def main():
     if not mcp_json.exists():
         errors.append(".mcp.json: File not found")
 
-    # 3. Every commands/*.md must have frontmatter
+    # 3. commands/ is optional (a plugin may be skill-only); if present, every
+    # commands/*.md must have frontmatter
     commands_dir = root / "commands"
     if commands_dir.is_dir():
         command_files = sorted(commands_dir.glob("*.md"))
-        if not command_files:
-            errors.append("commands/: No command files found")
         for f in command_files:
             if not has_frontmatter(f):
                 errors.append(f"commands/{f.name}: Missing YAML frontmatter")
-    else:
-        errors.append("commands/: Directory not found")
 
     # 4. Every skills/*/ directory must have a SKILL.md
     skills_dir = root / "skills"
@@ -60,17 +57,13 @@ def main():
     else:
         errors.append("skills/: Directory not found")
 
-    # 5. Every agents/*.md must have frontmatter
+    # 5. agents/ is optional (a plugin may be skill-only); if present, every
+    # agents/*.md must have frontmatter
     agents_dir = root / "agents"
     if agents_dir.is_dir():
-        agent_files = sorted(agents_dir.glob("*.md"))
-        if not agent_files:
-            errors.append("agents/: No agent files found")
-        for f in agent_files:
+        for f in sorted(agents_dir.glob("*.md")):
             if not has_frontmatter(f):
                 errors.append(f"agents/{f.name}: Missing YAML frontmatter")
-    else:
-        errors.append("agents/: Directory not found")
 
     # 6. Check for stray markdown files in root (not README, CLAUDE, LICENSE, or examples)
     expected_root_md = {"README.md", "CLAUDE.md", "CHANGELOG.md", "LICENSE", "token-optimization-findings.md"}

.mcp.json

@@ -5,8 +5,8 @@
       "url": "https://mcp.postman.com/${POSTMAN_MCP_MODE:-mcp}",
       "headers": {
         "X-Source": "claude-code-plugin",
-        "X-Plugin-Version": "1.3.1",
-        "User-Agent": "postman-claude-code-plugin/1.3.1"
+        "X-Plugin-Version": "2.0.0",
+        "User-Agent": "postman-claude-code-plugin/2.0.0"
       }
     }
   }