agent-skill-creator/references/phase5-implementation.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

1.3 KiB

Phase 5: Complete Implementation

Note

: This file is maintained for backwards compatibility. The complete, updated Phase 5 instructions are now in references/pipeline-phases.md (Section: Phase 5).

See references/pipeline-phases.md for the authoritative Phase 5 implementation guide, which includes:

  1. Create directory structure (no -cskill suffix)
  2. Write SKILL.md first (spec-compliant frontmatter with name, description, license, metadata)
  3. Implement Python scripts (functional, no placeholders)
  4. Write references (detailed documentation)
  5. Write assets (templates, configs)
  6. Generate install.sh (cross-platform installer)
  7. Write README.md (multi-platform install instructions)
  8. Run spec validation (scripts/validate.py)
  9. Run security scan (scripts/security_scan.py)
  10. Report results to user

Key Changes from v3.x

  • SKILL.md is created first (not marketplace.json)
  • No mandatory marketplace.json for simple skills
  • install.sh is generated for cross-platform support
  • Validation and security scan run automatically after generation
  • No -cskill suffix in generated skill names
  • Description must be <=1024 characters
  • Generated SKILL.md must be <500 lines

Quality Standards

See references/quality-standards.md and references/pipeline-phases.md for complete quality requirements.