chore: build system skill body rebased

[Rodriguespn]

What kind of change does this PR introduce?

Bug fix, feature, docs update, ...

What is the current behavior?

Please link any relevant issues here.

What is the new behavior?

Feel free to include screenshots if it includes visual changes.

Additional context

Add any other context or screenshots.

Summary by CodeRabbit

• Documentation

  • Restructured skill guides with improved organization, detailed usage workflows, prioritized rule categories, and reference sections.

• Chores

  • Enhanced skill validation for consistent naming, directory structure, and format compliance.

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

The pull request refactors the skill build pipeline and validation system. It simplifies SKILL.md parsing by removing heavy metadata processing, adds new structure validation utilities, updates AGENTS.md generation to use extracted SKILL.md body content, and reorganizes documentation for the supabase-postgres-best-practices skill.

Changes

Cohort / File(s)	Summary
Configuration .gitignore	Moved .claude/ entry from AI Agent directories block to Generated skills in dot directory block, reclassifying the ignore rule.
Build System Core packages/skills-build/src/build.ts, packages/skills-build/src/validate.ts	Simplifies frontmatter parsing with extractSkillBody() and parseSkillBodySections() functions; removes metadata-heavy preprocessing. Adds validation utilities (extractSkillName(), titleToKebab(), validateSkillStructure()) to enforce SKILL.md structure consistency. Removes skillNameToTitle from exports.
Documentation AGENTS.md, skills/supabase-postgres-best-practices/AGENTS.md	Updates AGENTS.md template description to reflect new body extraction approach. Restructures supabase-postgres-best-practices AGENTS.md with prioritized rule categories, expanded usage guidance, and standardized references section.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• chore: build system skill body #42: Modifies the same build.ts functions (extractSkillBody, parseSkillBodySections) and removes skillNameToTitle, with corresponding validate.ts updates using the new parsers.

Suggested labels

documentation

✨ 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 chore/build-system-skill-body-v2

Tip

Issue Planner is now in beta. Read the docs and try it out! Share your feedback on Discord.

---

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