skills.rest
shobcoder
shobcoderOFFICIAL
Explore all skills by this author →
GitHub

improve

Analyze a codebase read-only to produce prioritized implementation plans.

582|Updated Mar 25, 2026
Search Tags:#planning#architecture#execution#handoff#DX#code-audit
One-click install
npx skills add https://github.com/shobcoder/shob --skill improve-shobcoder
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve
Source: https://github.com/shobcoder/shob/tree/main/skills/improve
Command: npx skills add https://github.com/shobcoder/shob --skill improve-shobcoder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Survey a codebase as a senior advisor and produce prioritized, self-contained implementation plans for other models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

Core Features & Use Cases

  • Deep codebase understanding to identify high-value opportunities across correctness, security, performance, test coverage, tech debt, migrations, and DX.
  • Generate self-contained, executable plans that an executor can run in isolation without accessing the original repository.
  • Enforce strict read-only analysis and non-modification of source code; provide clear drift checks, verification steps, and success criteria.
  • Produce handoff-ready roadmaps and design-level plans that can be deployed by another agent or human reviewer.
  • Facilitate governance: document rationale, risks, and trade-offs to support decision making.

Quick Start

Provide prioritized executable improvement plan.

Frequently Asked Questions about improve

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

FAQPage Schema
What is a codebase audit for improvement opportunities?▼

A codebase audit for improvement opportunities analyzes source code in strict read-only mode to identify high-value targets across bugs, security, performance, test coverage, tech debt, migrations, and DX.

How do I generate executable implementation plans for other agents?▼

To generate executable implementation plans for other agents, survey the codebase and produce prioritized, self-contained handoff documents with explicit drift checks, verification steps, and success criteria.

How do I create a roadmap for future project direction and tech debt?▼

Create a roadmap for future project direction and tech debt by surveying the codebase as a senior advisor to document rationale, risks, trade-offs, and design-level handoff-ready plans.

Can I use an automated plan to fix security and performance issues directly?▼

No, this approach enforces strict read-only analysis and non-modification of source code; it provides prioritized plans and verification steps for an executor team or human reviewer to implement in isolation.

What are the limitations of read-only codebase analysis?▼

The main limitation of read-only codebase analysis is that it never implements, fixes, or refactors anything itself; it only generates self-contained governance documents and plans for downstream executors.

Related Skills

Explore More Software Engineering Skills→
BetaSBetaS

analyze

Analyze code repositories read-only to provide evidence-based insights.

Community
Advanced
James-GamboaJames-Gamboa

improve

Audit codebases and generate prioritized implementation plans for other agents.

Community
Advanced
saitocosaitoco

review

Coordinate acceptance criteria verification and multi-perspective reviews on GitHub pull requests.

Official
Advanced
loongclaw-ailoongclaw-ai
641

plan

Inspect repository context and draft timestamped Markdown plans under .hermes/plans.

Official
Intermediate