skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
hrdtbs/agent-skills52 installs

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-review
view source ↗

Is 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

  1. 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?
  2. List Deficiencies: Create a prioritized task list (- [ ]) of any gaps, omissions, or ambiguities found in the plan.
  3. Improve: Edit the plan to resolve the identified deficiencies. Update the plan using the appropriate tool.
  4. 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:

  1. Create new endpoint.
  2. 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.

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>