agentleFS
serbanghitaserbanghita/plan-critique-skills/skills/create/SKILL.md

create

Skill13 starsChanged 2 months agoMITView on GitHub

Create a new plan folder with a plan.md template

19 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use compare, publish and 3 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • n24q02mSkill

    compare

    Structured comparison of 2+ alternatives with consistent criteria and decision matrix

    Also in 3 projects that use this

  • VercelSkill

    publish

    Publish a single demo to v0 and optionally create Typefully drafts. Use when the user says "publish", "publish to v0", or "create typefully draft" for a demo.

    Also in 4 projects that use this

  • genomewalkerSkill

    tasks

    Browse and resume tasks, threads, and background jobs across sessions

    Also in 3 projects that use this

  • AnthropicSkill

    analyze

    Answer data questions -- from quick lookups to full analyses. Use when looking up a single metric, investigating what's driving a trend or drop, comparing segments over time, or preparing a formal data report for stakeholders.

    Also in 3 projects that use this

  • AnthropicSkill

    status

    Case status summary by audience — client-facing (plain language), internal (for the professor), or court-ready (formal caption format per local rules). Same facts, different framing and depth. Use when a student needs to update the client, brief the professor, or prepare a court status report.

    Also in 3 projects that use this

The file

Show its rules and text

We split this skill into the rules it gives an agent

19 rules. 0 are common, 5 are distinctive, and 14 are very specific to this project.

  • 0

    Common

    Most of the 17 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 14

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read the working agreement at working-agreement.md before step 1 and follow it for the whole run.

    line 11
  2. Distinctive:

    Ask clarifying questions up front when the request is ambiguous.

    line 17
  3. Very specific:

    Do not write, edit, or refactor any project code during this phase.

    line 19
  4. Very specific:

    Read .claude/plan-critique-config.json and get plansFolder path from settings.

    line 33
  5. Very specific:

    If the file doesn't exist or plansFolder is not set or is an empty string:

    line 34
  6. Very specific:

    Ask the user: "Where would you like to store your plans?

    line 35
  7. Distinctive:

    Create the folder if it doesn't exist

    line 38
  8. Very specific:

    Create an archived/ subfolder inside it

    line 39
  9. Very specific:

    If a name was passed as an argument, the text in $ARGUMENTS is the plan name.

    line 41
  10. Distinctive:

    Remove characters that are not alphanumeric or hyphens

    line 49
  11. Very specific:

    Check if [plansFolder]/[slug]/ already exists.

    line 52
  12. Very specific:

    If it does: Respond with "A plan with this name already exists at [plansFolder]/[slug]/.

    line 53
  13. Distinctive:

    Ask for a new name and repeat from step 4.

    line 54
  14. Very specific:

    Create the sessions directory if needed: [plansFolder]/.sessions/

    line 58
  15. Very specific:

    Write the slug to [plansFolder]/.sessions/[PID] (plain text, just the slug)

    line 59
  16. Very specific:

    Create the plan template at [plansFolder]/[slug]/plan.md using the template in plan-template.md.

    line 60
  17. Distinctive:

    Keep the original plan name with proper casing in the H1 heading of plan.md

    line 72
  18. Very specific:

    Only create plan.md initially (critique.md is created by /plan:critique)

    line 73
  19. Very specific:

    Always use plansFolder from settings as the base directory

    line 74

“Common” is measured: kept by at least 6 in 10 of the 17 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

You are creating a new plan folder for the user.

Fixed rules:

Read the working agreement at working-agreement.md before step 1 and follow it for the whole run. If that path does not resolve, look for working-agreement.md in the project root, then in .claude/. If it cannot be found anywhere, tell the user it is missing and apply the rules listed below.

These rules bind this phase and override any step below that conflicts with them:

  1. Ask clarifying questions up front when the request is ambiguous. Do not guess the plan name, the plans folder, or what the user means. Guessing here produces the wrong plan.
  2. Do not write, edit, or refactor any project code during this phase. This phase produces a plan folder and a plan.md and nothing else.
  3. The plan is not finished until it lists its affected files and how success will be verified. The template carries both sections, so do not remove them when filling it in.
  4. Be brief. No filler, no preamble, no restating the request. No emojis, no em dashes, no decorative icons.

To do this, follow these steps precisely:

  1. Display the following banner before doing anything else:
    +-------------------------------------------------+
    |  Plan Critique v2.6.1 - Creating new plan       |
    +-------------------------------------------------+
  2. Read .claude/plan-critique-config.json and get plansFolder path from settings. If the file doesn't exist or plansFolder is not set or is an empty string:
    • Ask the user: "Where would you like to store your plans? Provide a folder path (default .planning):". By default, the user should be presented with the option .planning.
    • Save the path as plansFolder in .claude/plan-critique-config.json
    • Create the folder if it doesn't exist
    • Create an archived/ subfolder inside it
  3. Determine the plan name:
    • If a name was passed as an argument, the text in $ARGUMENTS is the plan name. Use it directly.
    • Otherwise, ask the user directly, do not offer predefined options like "New Feature" or "Bug Fix" because the plan name must be unique: "Enter a name for this plan:" The plan name must have at least 3 characters. If it is empty or shorter, respond with "Plan name must be at least 3 characters." and ask the user to enter one.
  4. Generate a slug from the plan name:
    • Convert to lowercase
    • Replace spaces with hyphens
    • Remove characters that are not alphanumeric or hyphens
    • Trim to max 50 characters
    • Example: "Add User Authentication" becomes add-user-authentication
  5. Check if [plansFolder]/[slug]/ already exists. If it does: Respond with "A plan with this name already exists at [plansFolder]/[slug]/. Choose a different name." Ask for a new name and repeat from step 4.
  6. Create directory [plansFolder]/[slug]/
  7. Link this session to the new plan:
    • Get the Claude Code process ID by running: echo $PPID
    • Create the sessions directory if needed: [plansFolder]/.sessions/
    • Write the slug to [plansFolder]/.sessions/[PID] (plain text, just the slug)
  8. Create the plan template at [plansFolder]/[slug]/plan.md using the template in plan-template.md.
  9. Respond with confirmation:
    Created new plan: [plansFolder]/[slug]/
    Edit your plan at: [plansFolder]/[slug]/plan.md
    When ready, run `/plan:critique` to review your plan.

Notes:

  • The slug must be filesystem-safe (no special characters)
  • Keep the original plan name with proper casing in the H1 heading of plan.md
  • Only create plan.md initially (critique.md is created by /plan:critique)
  • Always use plansFolder from settings as the base directory

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.