bac2b27bb8
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>
30 lines
1.4 KiB
Markdown
30 lines
1.4 KiB
Markdown
# SC-001: Valid SKILL.md Frontmatter Generation
|
|
|
|
> Covers: FR-001 — Generated SKILL.md files MUST have valid frontmatter per the Agent Skills spec (name <=64 chars lowercase+hyphens, description <=1024 chars, both required)
|
|
> Type: Happy Path
|
|
|
|
## Given
|
|
- The meta-skill is invoked with a workflow description: "Create a skill for processing daily CSV files"
|
|
- The pipeline completes all 5 phases successfully
|
|
|
|
## When
|
|
- Phase 5 (Implementation) generates the SKILL.md file
|
|
|
|
## Then
|
|
- The generated SKILL.md begins with a YAML frontmatter block delimited by `---`
|
|
- The `name` field is present, lowercase, uses only hyphens as separators, and is <=64 characters (e.g., `csv-daily-processor`)
|
|
- The `description` field is present and is between 1 and 1024 characters
|
|
- The frontmatter block is valid YAML that can be parsed without errors
|
|
|
|
## Verification Method
|
|
|
|
**Method**: Automated test
|
|
|
|
**Steps**:
|
|
1. Run the meta-skill with input: "Create a skill for processing daily CSV files"
|
|
2. Read the generated `SKILL.md` file
|
|
3. Parse the YAML frontmatter between the `---` delimiters using Python `yaml.safe_load()`
|
|
4. Assert `name` is present, matches regex `^[a-z][a-z0-9-]*[a-z0-9]$`, and `len(name) <= 64`
|
|
5. Assert `description` is present and `1 <= len(description) <= 1024`
|
|
|
|
**Expected evidence**: YAML frontmatter parses successfully. `name` is a valid lowercase-kebab string <=64 chars. `description` is a non-empty string <=1024 chars. No YAML parsing errors.
|