Skip to content

improve background-process skill structure + description#2

Open
fernandezbaptiste wants to merge 1 commit intoIgorWarzocha:masterfrom
fernandezbaptiste:improve-background-process-skill
Open

improve background-process skill structure + description#2
fernandezbaptiste wants to merge 1 commit intoIgorWarzocha:masterfrom
fernandezbaptiste:improve-background-process-skill

Conversation

@fernandezbaptiste
Copy link
Copy Markdown

hey @IgorWarzocha, thanks for building the opencode background process tool. really like the clean approach to process lifecycle management. kudos for the repo! just starred it.

ran your background-process skill through some evals and noticed a few things that were pretty quick to improve (moving from ~77% to ~89% agent performance):

  • expanded description with concrete actions like port conflict resolution, startup verification, stale process cleanup

  • added explicit port conflict resolution workflow with step-by-step commands (lsof, kill, verify, relaunch)

  • added startup failure recovery guidance so agents know what to do when a process fails to start

these were easy 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 1 skill, 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.

- expand description with concrete actions + trigger terms
- add port conflict resolution workflow with step-by-step commands
- add startup failure recovery guidance
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.

1 participant