chore: build system skill body

[Rodriguespn]

Summary by CodeRabbit

• Documentation

  • Simplified generated guide structure, removing metadata-driven reference sections
  • Redesigned Supabase best practices guide with new prioritized categorization scheme and refined usage flow
  • Enhanced skill metadata validation for consistency

• Refactor

  • Updated skill parsing and guide generation approach

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This PR refactors SKILL.md parsing to extract and process body content instead of frontmatter metadata. It removes frontmatter-based title generation and metadata-driven AGENTS.md sections, and introduces skill structure validation that checks consistency between frontmatter, directory names, and body content.

Changes

Cohort / File(s)	Summary
Build system refactoring packages/skills-build/src/build.ts	Removed frontmatter extraction and metadata-driven section generation. Added extractSkillBody() to isolate body content and parseSkillBodySections() to extract optional H1 title. AGENTS.md generation now includes only title, Structure/Usage blocks, and remaining body content. Replaced createClaudeSymlink() with generic createSymlink(). Removed skillNameToTitle export.
Validation enhancements packages/skills-build/src/validate.ts	Added skill structure validation with new helpers: extractSkillName() reads frontmatter, titleToKebab() converts titles to kebab-case, and validateSkillStructure() checks that name field exists, matches directory, and body starts with H1 matching directory name. Enhanced validateSkill() to perform structure validation early and abort if name errors exist.
Documentation updates AGENTS.md, skills/supabase-postgres-best-practices/AGENTS.md	Updated AGENTS.md documentation string from "navigation guide" to "SKILL.md body (frontmatter stripped)". Completely rewrote supabase skill AGENTS.md content from enumeration-based to prioritized rule-based guide with simplified reference structure and new usage patterns.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~22 minutes

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/build-system-skill-body

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}