Commit Graph

15 Commits

Author SHA1 Message Date
Pedro Rodrigues
1718f83632 Revert "fix: remove CLAUDE.md symlink generation from build"
This reverts commit c07c234601.
2026-01-30 13:40:52 +00:00
Pedro Rodrigues
bec143f6ce 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>
2026-01-30 13:40:26 +00:00
Pedro Rodrigues
22e466937a fix: require reference files at root of references/ directory (#32)
Remove support for nested subdirectories in references/.
All markdown reference files must now be placed directly in
the references/ directory (e.g., references/auth-signup.md).

- Replace getMarkdownFilesRecursive with getMarkdownFiles (flat)
- Simplify parseAllSections to only read root _sections.md
- Update getReferenceFiles to skip subdirectories
- Keep deprecated getMarkdownFilesRecursive alias for compatibility

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 13:39:59 +00:00
Pedro Rodrigues
a3b815155c reduxe the agents.md file size (#20) 2026-01-27 21:38:29 +00:00
Pedro Rodrigues
5da9a5ee37 feat: add subdirectory support for reference files (#18)
- 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>
2026-01-27 18:34:52 +00:00
Pedro Rodrigues
f421451c79 chore: comply with agent skills open stardard (#14) 2026-01-26 15:22:35 +00:00
Pedro Rodrigues
bbde7ff5f8 refactor: generic skills build system with auto-discovery (#8)
* 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>
2026-01-23 15:56:11 +00:00
Pedro Rodrigues
7b1a65007b automatically reorder sections on agents.md by priority 2026-01-22 08:48:47 +00:00
Pedro Rodrigues
f323d3b601 Add Biome formatter/linter and restore CI workflow (#6)
- 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>
2026-01-22 08:28:49 +00:00
Pedro Rodrigues
221215b707 final review 2026-01-21 16:53:34 +00:00
Pedro Rodrigues
663d784e24 remove extract tests 2026-01-21 16:44:38 +00:00
Pedro Rodrigues
c63a5fa509 second reviewe 2026-01-21 16:32:52 +00:00
Pedro Rodrigues
8df22b058d chore: bump version to 1.0.0 (#4)
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>
2026-01-21 15:40:53 +00:00
Pedro Rodrigues
06a4e68d30 Rename postgresql to postgres (keeping only existing files) 2026-01-19 19:31:34 +00:00
Pedro Rodrigues
0a543e1b4a Initial setup: PostgreSQL best practices repository
Skeleton structure for Supabase PostgreSQL experts to add performance
optimization rules. Modeled after Vercel's react-best-practices-build.

Includes:
- Build system (parser, validator, builder)
- Skill manifest and metadata
- Rule templates and writing guidelines
- CI workflow for validation
- Getting started guide for Postgres team

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 09:52:32 +07:00