admin-valentin/agent-skill-creator
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
agent-skill-creator/.clarity/plan.md
francylisboacharuto bac2b27bb8 feat: v4.0 Cross-Platform Modernization — Agent Skills Open Standard compliance 
BREAKING CHANGES:
- Remove -cskill suffix from all skill names (use standard kebab-case)
- Simplify marketplace.json to only official fields (fixes Issue #5)
- SKILL.md body must be <500 lines (progressive disclosure via references/)

New features:
- Cross-platform support for 8+ platforms (Claude Code, Copilot, Cursor, Windsurf, Cline, Codex CLI, Gemini CLI)
- scripts/install-template.sh: Auto-detect platform installer with --dry-run
- scripts/validate.py: Spec compliance checker for generated skills
- scripts/security_scan.py: Security scanner for hardcoded keys and dangerous patterns
- MIGRATION.md: v3.x to v4.0 migration guide
- 6 new reference files for progressive disclosure from lean SKILL.md

Key changes:
- SKILL.md: 4,116 → 272 lines with spec-compliant YAML frontmatter
- marketplace.json: Stripped to {name, plugins} only
- article-to-prototype-cskill/ → article-to-prototype/
- stock-analyzer-cskill/ → stock-analyzer/
- Export system integrates validation + security scanning
- README.md rewritten for all supported platforms
- Phase 5 pipeline outputs SKILL.md-first, spec-compliant skills

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-26 14:52:09 -03:00

3.1 KiB
Raw Blame History

Implementation Plan: agent-skill-creator v4.0 — Cross-Platform Modernization

Generated by /clarity on 2026-02-26 Full spec: .clarity/spec.md Handoff: .clarity/handoff.md Holdout scenarios: scenarios/ (59 scenarios covering all 28 FRs + 7 NFRs)

Summary

Modernize agent-skill-creator from a Claude-only meta-skill (v3.2) to a cross-platform skill factory (v4.0) that generates skills compliant with the Agent Skills Open Standard (agentskills.io). Skills will work on Claude Code, GitHub Copilot CLI, VS Code Copilot, Cursor, Windsurf, Cline, OpenAI Codex CLI, Gemini CLI, and any future SKILL.md adopter — without modification.

What Changes

Area Before (v3.2) After (v4.0)
SKILL.md 4,116 lines (monolith) <500 lines + references/
marketplace.json Non-standard fields (Issue #5) Official fields only, optional
Naming -cskill suffix mandatory Standard kebab-case, no suffix
Platforms 4 (Claude Code/Desktop/Web/API) 8+ (all SKILL.md adopters)
Validation None Spec compliance + security scan
Install UX Manual per-platform install.sh auto-detects platform
Phase 5 output marketplace.json first SKILL.md first (primary file)

What Stays the Same

  • 5-phase pipeline (Discovery → Design → Architecture → Detection → Implementation)
  • AgentDB integration (optional, graceful degradation)
  • Simple skill vs Complex suite architecture support
  • Desktop/Web .zip export and API .zip export
  • All activation trigger phrases

Implementation Steps (8 steps, ~3 phases)

Phase A: Fix the Meta-Skill Itself

Step 1 — Restructure SKILL.md: 4,116 → <500 lines with progressive disclosure to references/ Step 2 — Fix marketplace.json: Strip non-standard fields (fixes Issue #5)

Phase B: Update the Skill Generation Pipeline

Step 3 — Update Phase 5: SKILL.md-first (not marketplace.json), spec-compliant output, validation + security scan Step 4 — Remove -cskill naming convention everywhere (code, docs, examples, rename article-to-prototype-cskill/)

Phase C: Add Cross-Platform Tooling

Step 5 — Create install.sh template: Auto-detects Claude Code, Copilot, Cursor, Windsurf, Cline, Codex, Gemini Step 6 — Create validate.py + security_scan.py: Spec validation + OWASP-lite security checks Step 7 — Update export system: Multi-platform install guide, validation before export Step 8 — Update all documentation: README v4.0, MIGRATION.md, CHANGELOG, cross-platform guide

Key Deliverables

  1. .clarity/spec.md — Full specification (28 FRs, 7 NFRs, data model, API contracts)
  2. .clarity/handoff.md — Self-contained implementation prompt for any AI coding agent
  3. scenarios/SC-001..SC-059 — 59 holdout test scenarios for independent evaluation
  4. .clarity/context.md — Research context and ecosystem analysis

Open Questions (4)

  1. Should the tool offer direct publishing to SkillsMP/SkillHub?
  2. Should install.sh support --uninstall?
  3. Should validation check that referenced files exist?
  4. Should Cursor export generate .mdc or rely on native SKILL.md support?