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>
1.2 KiB
1.2 KiB
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:
- Generate a skill with a very complex workflow that produces extensive documentation
- Count lines in SKILL.md:
wc -l SKILL.md - Assert line count <500
- List files in
references/:ls references/ - Assert at least one reference file contains content from the original SKILL.md draft
- 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.