maiconfz--ai-first-project-readiness--improvement-planner

Drafts phased or full-shot AI-readiness improvement plans from a readiness report without implementing changes.

3|1|Updated May 2, 2026
One-click install
npx skills add https://github.com/agents-repo/registry --skill maiconfz-ai-first-project-readiness-improvement-planner-agents-repo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maiconfz--ai-first-project-readiness--improvement-planner
Source: https://github.com/agents-repo/registry/tree/main/.cursor/skills/maiconfz/ai-first-project-readiness/maiconfz--ai-first-project-readiness--improvement-planner
Command: npx skills add https://github.com/agents-repo/registry --skill maiconfz-ai-first-project-readiness-improvement-planner-agents-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After an AI-readiness audit produces a report of gaps, teams still need a concrete, ordered plan to close those gaps. This Skill turns a readiness report into a plan-only improvement roadmap while strictly refusing to implement, commit, or modify any host project files. ## Core Features & Use Cases - Consent-gated planning: Never drafts a plan until the user explicitly consents; unresolved consent or missing plan mode becomes a blocking question instead of an assumption. - Two plan shapes: Produces either a phased plan (ordered phases with exit criteria) or a full-shot plan (one sequenced plan covering all gaps). - Grounded, non-invasive output: Ties goals, steps, touched files, risks, and validation to the readiness report and the host repo's own documented commands, without inventing another repo's tooling. - Use Case: After running an AI-readiness analysis on a repository, feed the resulting report into this Skill, choose phased mode, and receive a markdown improvement plan listing phases, exit criteria, risks, and non-goals for review before any implementation work begins. ## Quick Start Ask the agent to draft a phased improvement plan from the readiness report after confirming you consent to planning.

Frequently Asked Questions about maiconfz--ai-first-project-readiness--improvement-planner

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

FAQPage Schema
How do I turn an AI-readiness report into an improvement plan?▼

Provide the readiness report, set planning consent to true, and choose a plan mode of phased or full-shot. The Skill then drafts a markdown improvement plan with goals, ordered steps, touched files, risks, and validation, without modifying any files.

What is the difference between phased and full-shot plan modes?▼

Phased mode produces ordered phases, each with exit criteria, so work can be reviewed incrementally. Full-shot mode produces one sequenced plan covering the same gaps in a single pass. The Skill asks which mode to use rather than assuming one.

Does the improvement planner implement or change repository files?▼

No. The Skill is plan-only by design. It must not create, modify, commit, or push host files, and it must not call gh or open pull requests. It only outputs a markdown plan and any blocking questions.

What happens if planning consent or plan mode is missing?▼

Planning stops. The Skill leaves the improvement plan empty, records the missing consent or mode as a blocking question, and asks the user before proceeding rather than making assumptions.

Can it reuse a readiness report generated in a chat-web session?▼

No. A chat-web readiness report is treated as remote-or-upload evidence for chat-web only. The Skill must not present it as a host-tree improvement plan, keeping the two contexts separate.