Skip to content

fix: skill-forge review — frontmatter, reference splits, terminology, README#2

Open
whiletrue0x wants to merge 3 commits into
featbit:mainfrom
whiletrue0x:main-clean
Open

fix: skill-forge review — frontmatter, reference splits, terminology, README#2
whiletrue0x wants to merge 3 commits into
featbit:mainfrom
whiletrue0x:main-clean

Conversation

@whiletrue0x

Copy link
Copy Markdown

Summary

Full Skill Forge review of all 17 skills with automated validation and fixes:

  • Add YAML frontmatter to all 15 reference files (enables AI agents to assess relevance before reading)
  • Split 3 oversized references into focused files — troubleshooting.md (919→6 files), environment-variables.md (754→5 files), standard-configuration.md (429→3 files) — reducing per-file token cost by 3-4x
  • Trim projects-api.md (373→288) and track-insights-api.md (306→295) under the 300-line limit
  • Add Execution Procedure to deployment-docker and deployment-kubernetes (intent routing for AI agents)
  • Add Quick Start workflow to deployment-kubernetes (was just a link index, now has actionable Helm steps)
  • Standardize terminology to "feature flag" across 6 SDK skills (~35 prose edits, code API names untouched)
  • Clarify SDK setup examples with // replace with your FeatBit server URL comments on localhost URLs
  • Improve README — logo with dark/light mode, features section, value-proposition one-liner, reference-style badges
  • Add GitHub metadata.github/repo-meta.yml with description + 13 topics

See REVIEW.md for the full quality improvement report with before/after metrics and validation results.

Validation

  • 17/17 skills pass all security, structure, and quality checks
  • 28/28 reference files have frontmatter and are under 300 lines
  • All internal links resolve
  • Self-review: 6/6 dimensions aligned

Test plan

  • Verify npx skills add featbit/featbit-skills --list shows all 17 skills
  • Spot-check split reference files render correctly on GitHub
  • Verify README logo renders in both light and dark GitHub themes
  • Confirm no broken links in skill catalog table

🤖 Generated with Claude Code

whiletrue0x and others added 3 commits March 30, 2026 12:56
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…EADME

Skill-forge full review of all 17 skills:

- Add YAML frontmatter to all 15 reference files (6 skills)
- Split 3 oversized references into focused files:
  - environment-variables.md (754→5 files)
  - troubleshooting.md (919→6 files)
  - standard-configuration.md (429→3 files)
- Trim projects-api.md (373→288 lines) and track-insights-api.md (306→295)
- Add Execution Procedure to deployment-docker and deployment-kubernetes
- Add Quick Start workflow to deployment-kubernetes
- Standardize "feature flag" terminology across 6 SDK skills
- Add localhost replacement comments in SDK setup examples
- Improve README: logo, features section, reference-style badges, footer
- Add .github/repo-meta.yml for GitHub metadata

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Full Skill Forge review report covering all 17 skills.
Summarizes findings, fixes, and validation results for PR review.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant