plan-self-review
Self-evaluate a plan on a 100-point scale after it is created or updated. Make sure to use this skill immediately whenever you create a plan or update a plan, even if the user does not explicitly ask for a review. This skill ensures that the plan is clear, comprehensive, feasible, and consistent before execution.
How do I install this agent skill?
npx skills add https://github.com/hrdtbs/agent-skills --skill plan-self-reviewIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a structured framework for the AI agent to self-evaluate and improve its own plans. It contains no executable code, network operations, or sensitive data access.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
What does this agent skill do?
Plan Self-Review
Use this skill immediately after creating or updating a plan. Catching logical gaps, ambiguous steps, or missing dependencies early prevents cascading failures during execution. Self-reviewing your plan helps you approach the problem methodically and reduces the likelihood of needing major revisions later.
Review Steps
- Score Plan (100pt): Evaluate the plan based on the following criteria:
- Clarity (25): Are the steps clear and easy to follow? Do they specify which files and tools will be used?
- Comprehensiveness (25): Does the plan cover all necessary aspects of the task? Are there any unaddressed edge cases?
- Feasibility (25): Are the steps achievable with the available tools and context? Do you have enough information to execute them?
- Consistency (25): Are there any logical contradictions or missing elements? Do the steps follow a logical sequence?
- List Deficiencies: Create a prioritized task list (
- [ ]) of any gaps, omissions, or ambiguities found in the plan. - Improve: Edit the plan to resolve the identified deficiencies. Update the plan using the appropriate tool.
- Final Check: Perform a final check to confirm no logical contradictions or missing elements remain.
Output Format
Present your review using the following structure:
Self-Evaluation Score: [Score]/100
- Clarity: [Score]/25
- Comprehensiveness: [Score]/25
- Feasibility: [Score]/25
- Consistency: [Score]/25
Deficiencies
- [Deficiency 1]
- [Deficiency 2]
Improvements Made
- [Briefly describe the improvements made to the plan]
Final Check
- [Confirm that the plan is now logically sound and complete]
Examples
Example 1: Reviewing a plan for adding a new API endpoint
Initial Plan:
- Create new endpoint.
- Update tests.
Self-Review Output:
Self-Evaluation Score: 40/100
- Clarity: 10/25 (Missing details on which file to edit and what the endpoint does)
- Comprehensiveness: 10/25 (Missing documentation update, error handling details)
- Feasibility: 10/25 (Too vague to execute without further clarification)
- Consistency: 10/25 (Logically sound but lacks concrete steps)
Deficiencies
- Specify the exact file and route for the new endpoint
- Add error handling requirements
- Identify which test file needs to be updated and what test cases to add
- Include a step to update the API documentation
Improvements Made
- Updated the plan to specify the target file (
src/api/users.js) and route (POST /users). - Added a sub-step for implementing input validation and error handling.
- Specified the test file (
tests/api/users.test.js) and explicitly required testing the error cases. - Added a step to update
docs/api.md.
Final Check
- The revised plan is now clear, comprehensive, and specifies exact files and actions. It is logically sound and ready for execution.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/hrdtbs/agent-skills/plan-self-review">View plan-self-review on skillZs</a>