Skip to content

improve rulesync skill for better agent matching#1435

Open
fernandezbaptiste wants to merge 1 commit intodyoshikawa:mainfrom
fernandezbaptiste:improve-rulesync-skill
Open

improve rulesync skill for better agent matching#1435
fernandezbaptiste wants to merge 1 commit intodyoshikawa:mainfrom
fernandezbaptiste:improve-rulesync-skill

Conversation

@fernandezbaptiste
Copy link
Copy Markdown

@fernandezbaptiste fernandezbaptiste commented Apr 3, 2026

hey @dyoshikawa, thanks for building rulesync. really like the unified approach to AI rule file management across tools. kudos on getting close to 1k stars! just starred it.

ran your rulesync skill through some evals and improved agent performance from ~37% to ~99%:

  • improved description with concrete actions, specific file types (.cursorrules, CLAUDE.md), and trigger terms for better agent matching
  • replaced the table-of-contents body with an inline quick start, core workflow steps, and key commands table so agents can act immediately
  • updated scripts/sync-skill-docs.ts to generate the improved SKILL.md so the build stays clean
  • kept all existing linked reference docs intact in a compact detailed reference section

these were straightforward changes to bring the skill in line with what performs well against Anthropic's best practices. honest disclosure, I work at tessl.io where we build tooling around this. not a pitch, just fixes that were straightforward to make.

you've got 17 skills here, if you want to do it yourself, spin up Claude Code and run tessl skill review. alternatively, let me know if you'd like an automatic review in your repo via GitHub Actions. it doesn't require signup, and this means you and your contributors get an instant quality signal before you have to review yourself.

@dyoshikawa
Copy link
Copy Markdown
Owner

@fernandezbaptiste thank you. please check the cicheck failure.

@fernandezbaptiste fernandezbaptiste force-pushed the improve-rulesync-skill branch 2 times, most recently from 131a3f1 to 5457270 Compare April 3, 2026 11:53
@fernandezbaptiste fernandezbaptiste changed the title improve rulesync skill description for better agent matching improve rulesync skill for better agent matching Apr 3, 2026
@fernandezbaptiste fernandezbaptiste force-pushed the improve-rulesync-skill branch 2 times, most recently from 45385a0 to 2c50d03 Compare April 3, 2026 11:58
@fernandezbaptiste
Copy link
Copy Markdown
Author

fixed! the cicheck was failing because oxfmt wanted to reformat the files. pushed a new commit with the formatter applied — all checks pass now. also improved the skill further (quick start workflow, command reference table, error recovery section).

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.

2 participants