agent-skill-creator/scenarios/SC-030-readme-multiplatform-instructions.scenario.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.2 KiB

SC-030: Generated README.md Includes Multi-Platform Installation

Covers: FR-018, FR-026 — README MUST include installation instructions for at least 5 platforms with copy-paste commands Type: Happy Path

Given

  • The meta-skill is invoked with: "Create a skill for git commit message generation"

When

  • Phase 5 generates the README.md

Then

  • The generated README.md contains a "Cross-Platform Installation" section (or equivalent)
  • The section includes copy-paste commands for at least 5 platforms:
    • Claude Code
    • GitHub Copilot
    • Cursor
    • Windsurf
    • Cline (or Codex CLI, or Gemini CLI)
  • Each platform section includes the exact shell command to install

Verification Method

Method: CLI command

Steps:

  1. Run the meta-skill to generate the skill
  2. Run: grep -i "claude code\|copilot\|cursor\|windsurf\|cline\|codex\|gemini" git-commit-generator/README.md | wc -l
  3. Assert count >= 5
  4. Run: grep -c "install\|cp\|copy\|mkdir" git-commit-generator/README.md
  5. Assert count >= 5 (at least one command per platform)

Expected evidence: README.md contains a "Cross-Platform Installation" section. At least 5 distinct platforms are listed with shell commands like cp -r or ./install.sh --platform.