improve

Audit codebases and generate prioritized implementation plans for other agents.

Updated Oct 2, 2024
One-click install
npx skills add https://github.com/James-Gamboa/portfolio-james --skill improve-james-gamboa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: improve
Source: https://github.com/James-Gamboa/portfolio-james/tree/main/.agents/skills/improve
Command: npx skills add https://github.com/James-Gamboa/portfolio-james --skill improve-james-gamboa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps senior advisors deeply understand a codebase, identify the highest-value improvement opportunities, and deliver prioritized, self-contained implementation plans that another model can execute without touching source code.

Core Features & Use Cases

  • Prioritized audit findings: surface the most impactful correctness, security, performance, test coverage, tech debt, and DX improvements.
  • Plan generation: produce execution-ready, self-contained plans that include scope, steps, verification gates, tests, and forward-maintenance notes.
  • Executor-grade outputs: documentation and artifacts tailored for an automated executor to implement, verify, and maintain.

Quick Start

Provide a prioritized, self-contained implementation plan for improving a codebase that another agent can execute without touching the source code.

Frequently Asked Questions about improve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn code review findings into actionable implementation plans?

Code audits scope correctness, security, performance, tests, tech debt, and DX to surface high-impact improvement opportunities. They deliver prioritized, self-contained implementation plans with verification gates tailored for automated executors.

How do I generate execution plans for code improvements without modifying source code?

You generate execution plans by scoping code audits for high-impact improvements and producing self-contained plans with steps, verification gates, tests, and dependencies that another agent can execute in isolation without touching source code.

Can I use automated code audits to prioritize tech debt and DX improvements?

Yes, automated code audits can prioritize tech debt and DX improvements. They scope the codebase to detect high-impact issues across correctness, security, performance, and test coverage, delivering prioritized implementation plans for executors.

What is the best way to scope a codebase audit for automated execution?

The best way to scope a codebase audit for automated execution is to detect correctness, security, performance, tests, tech debt, and DX issues, then present prioritized plans with clear verification steps, tests, and dependencies for isolated execution.

Does code audit planning provide verification steps for executor agents?

Yes, code audit planning provides verification steps for executor agents. It delivers self-contained implementation plans that include scope, steps, verification gates, tests, and forward-maintenance notes so executors can run them in isolation.

Why do my automated code improvement plans fail to execute in isolation?

Automated code improvement plans fail to execute in isolation when they lack clear verification steps, tests, and dependencies. Self-contained plans must provide scope, execution steps, and forward-maintenance notes for an executor to run without modifying source code.