agent-skill-creator/scenarios/SC-047-skillmd-excess-moved-to-references.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

30 lines
1.2 KiB
Markdown

# SC-047: Excess SKILL.md Content Moved to References
> Covers: FR-003, Edge case 2.3 — SKILL.md body exceeds 500 lines: move excess to references, add cross-references
> Type: Edge Case
## Given
- During Phase 5, the initial SKILL.md draft has 750 lines of body content
## When
- The line-count check runs and detects the excess
## Then
- The SKILL.md is trimmed to <500 lines
- The excess content is extracted and saved to one or more files in `references/`
- The SKILL.md body contains cross-reference links like `See references/detailed-guide.md for full documentation`
- No content is lost -- it is all preserved in `references/`
## Verification Method
**Method**: Automated test
**Steps**:
1. Generate a skill with a very complex workflow that produces extensive documentation
2. Count lines in SKILL.md: `wc -l SKILL.md`
3. Assert line count <500
4. List files in `references/`: `ls references/`
5. Assert at least one reference file contains content from the original SKILL.md draft
6. Grep SKILL.md for cross-references: `grep 'references/' SKILL.md`
**Expected evidence**: SKILL.md is <500 lines. `references/` contains extracted detail files. SKILL.md body contains at least one `references/` cross-reference.