* feat: supabase db references
* refactor: move database references to db subdirectory
Move all database reference files to references/db/ to organize
by product area and take advantage of the new subdirectory support
in the build system.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* fix: remove CLAUDE.md symlink generation from build
The CLAUDE.md symlink causes installation errors when using
`npx skills add` as it tries to copy AGENTS.md to itself.
- Remove createClaudeSymlink function from build.ts
- Remove claudeSymlink from SkillPaths interface
- Remove CLAUDE.md references from AGENTS.md structure documentation
- Delete existing CLAUDE.md symlink from skills directory
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* test: add sanity test for skills installation
Add a sanity test that verifies the skills CLI installation works:
- Runs `npx skills add . -a claude-code -y` using current directory
- Checks command doesn't fail (exit code 0)
- Verifies .claude/skills directory is created
- Dynamically discovers skills in the repo and verifies they're installed
- Checks SKILL.md exists in each installed skill
The test runs on every push to main and pull requests.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* Revert "fix: remove CLAUDE.md symlink generation from build"
This reverts commit c07c234601.
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Add a sanity test that verifies the skills CLI installation works:
- Runs `npx skills add . -a claude-code -y` using current directory
- Checks command doesn't fail (exit code 0)
- Verifies .claude/skills directory is created
- Dynamically discovers skills in the repo and verifies they're installed
- Checks SKILL.md exists in each installed skill
The test runs on every push to main and pull requests.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The CLAUDE.md symlink causes installation errors when using
`npx skills add` as it tries to copy AGENTS.md to itself.
- Remove createClaudeSymlink function from build.ts
- Remove claudeSymlink from SkillPaths interface
- Remove CLAUDE.md references from AGENTS.md structure documentation
- Delete existing CLAUDE.md symlink from skills directory
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add getMarkdownFilesRecursive() for recursive file scanning
- Add parseAllSections() to parse _sections.md from subdirectories
- Add parseSectionsFromFile() helper function
- Update buildSkill() and validateSkill() to use new functions
- Export new functions for use by validate.ts
This allows organizing reference files in product-specific subdirectories
(e.g., references/db/ for database files) while keeping _sections.md in
each subdirectory.
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
* refactor: generic skills build system with auto-discovery
- Rename postgres-best-practices-build → skills-build
- Add auto-discovery: scans skills/ for subdirectories with metadata.json
- Build/validate all skills or specific skill with -- argument
- Update root AGENTS.md and CONTRIBUTING.md with new structure
- No configuration needed to add new skills
Usage:
npm run build # Build all skills
npm run build -- skill-name # Build specific skill
npm run validate # Validate all skills
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* fix ci
* more generic impact levels
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
- Install Biome as the project formatter and linter
- Configure Biome with recommended settings
- Add format, lint, and check scripts to package.json
- Restore CI workflow from git history (commit 0a543e1)
- Extend CI with new Biome job for format and lint checks
- Apply Biome formatting to all TypeScript files
- Fix linting issues (use node: protocol, template literals, forEach pattern)
CI now runs on:
- All pushes to main branch
- All pull requests
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
* feat: add marketplace.json for Claude Code plugin distribution
Add .claude-plugin/marketplace.json to enable distribution of the
postgres-best-practices skill as a Claude Code plugin.
Users can install via:
/plugin marketplace add supabase/agent-skills
/plugin install postgres-best-practices@supabase-postgres
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* feat: add plugin.json manifest for postgres-best-practices skill
Add .claude-plugin/plugin.json inside the skill directory to properly
define this as a Claude Code plugin. This is required by the marketplace
specification - each plugin must have its own plugin.json manifest.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* chore: update marketplace name and description for broader scope
- Rename marketplace from supabase-postgres to supabase-plugins
- Update description to reflect this as the official Supabase agent skills repo
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* minor fixes
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Update version from 0.1.0 to 1.0.0 across all files:
- skills/postgres-best-practices/AGENTS.md
- skills/postgres-best-practices/SKILL.md
- skills/postgres-best-practices/metadata.json
- packages/postgres-best-practices-build/package.json
- packages/postgres-best-practices-build/package-lock.json
- packages/postgres-best-practices-build/src/build.ts
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
