Agent skill

implement-improvements

Plan and implement improvements from the .turbo/improvements.md backlog after validating them against the current codebase. Use when the user asks to "implement improvements", "work on improvements", "address improvements", "process improvement backlog", "tackle improvements", or "implement noted improvements".

Stars 261
Forks 21

Install this agent skill to your Project

npx add-skill https://github.com/tobihagemann/turbo/tree/main/skills/implement-improvements

SKILL.md

Implement Improvements

Validate and implement improvements from .turbo/improvements.md.

Step 1: Read the Backlog

Read .turbo/improvements.md. If the file does not exist, tell the user there are no improvements to implement and stop.

Parse all entries, extracting for each:

  • Summary (the ### heading)
  • Category
  • Where (file paths or areas)
  • Why (rationale)
  • Noted (date)

Step 2: Validate Against Current Codebase

Improvements can go stale: files get renamed, code gets refactored, issues get fixed as side effects of other work. Before planning, validate each improvement.

For each entry, verify whether the specific problem or opportunity described in the entry still exists in the code. Do not rely on git log alone. Recent commits touching the same files do not mean the specific issue was addressed. Read the actual code and confirm:

  1. Files exist — Do the referenced files/paths still exist? If not, the entry is stale.
  2. Problem persists — Read the relevant code sections. Is the exact issue or opportunity described in the entry still present? This is the primary determination. Check the specific claims: if the entry says a function is uncalled, verify it has no callers; if it says error handling is missing, check whether it was added.

Classify each entry as:

  • Active — The described problem or opportunity is confirmed present in the current code
  • Stale — The referenced files no longer exist, or the specific issue has been resolved (cite the evidence: what changed and where)
  • Unclear — Cannot determine from code alone, needs user input

When in doubt, classify as Active. The cost of re-examining a resolved issue is low; dismissing a valid improvement is high.

Step 3: Report Findings

Present a summary to the user:

## Improvement Backlog Status

### Active (N)
- [summary] — [one-line reason it's still relevant]

### Stale (N)
- [summary] — [one-line reason it's stale]

### Unclear (N)
- [summary] — [what's ambiguous]

If there are more than 10 active improvements, suggest splitting into multiple sessions.

Use AskUserQuestion to confirm:

  1. Which active improvements to implement (default: all; suggest a subset if splitting)
  2. Whether to remove stale entries from the backlog
  3. Resolution for any unclear items

Step 4: Run /turboplan Skill

Run the /turboplan skill with the confirmed active improvements as the task description. Include these planning constraints:

  • Synergies — Group improvements that touch the same files or areas
  • Dependencies — Order so foundational changes come first
  • Conflicts — Flag if two improvements contradict each other

Tell turboplan that the plan must include a final implementation step: "Clean up .turbo/improvements.md — remove implemented and stale entries, keep skipped or deferred ones, delete the file if all entries are removed."

Expand your agent's capabilities with these related and highly-rated skills.

tobihagemann/turbo

review-api-usage

Check API, library, and framework usage in code against official documentation and installed skill knowledge. Flags deprecated APIs, incorrect method signatures, wrong parameter types, version-incompatible patterns, and best-practice violations. Use when the user asks to "review API usage", "check API usage", "verify against docs", "check library usage", "validate API calls", "check against documentation", or "check for deprecated APIs".

261 21
Explore
tobihagemann/turbo

resolve-pr-comments

Evaluate, fix, answer, and reply to GitHub pull request review comments. Handles both change requests (fix or skip) and reviewer questions (explain using reasoning recalled from past Claude Code transcripts). Use when the user asks to "resolve PR comments", "fix review comments", "address PR feedback", "handle review comments", "address review feedback", "respond to PR comments", "answer review questions", or "address code review".

261 21
Explore
tobihagemann/turbo

consult-codex

Multi-turn consultation with Codex CLI for second opinions, brainstorming, or collaborative problem-solving. Use when the user asks to "consult codex", "ask codex", "get codex's opinion", "brainstorm with codex", "discuss with codex", or "chat with codex".

261 21
Explore
tobihagemann/turbo

review-tooling

Detect what dev tooling infrastructure a project has and flag gaps across linters, formatters, pre-commit hooks, test runners, and CI/CD pipelines. Returns structured findings without applying changes. Use when the user asks to "review tooling", "check project tooling", "what tooling is missing", "review dev infrastructure", or "tooling audit".

261 21
Explore
tobihagemann/turbo

create-changelog

Create a CHANGELOG.md following keepachangelog.com conventions with version history backfilled from GitHub releases or git tags. Use when the user asks to "create a changelog", "add a changelog", "initialize changelog", "start a changelog", "set up changelog", "generate changelog", or "backfill changelog".

261 21
Explore
tobihagemann/turbo

update-changelog

Update the Unreleased section of CHANGELOG.md based on current changes. No-op if CHANGELOG.md does not exist. Use when the user asks to "update changelog", "add to changelog", "update the changelog", "changelog entry", "add changelog entry", or "log this change".

261 21
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results