Agent skill

Plan Writing

by xenitV1 in xenitV1/Antigravity-Workflows

Structured task planning with clear breakdowns, dependencies, and verification criteria.

MITAuto-check passedDevelopment

Install Plan Writing

skills CLI
$ npx skills add xenitV1/Antigravity-Workflows --skill plan-writing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install xenitV1/Antigravity-Workflows plan-writing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/xenitV1/Antigravity-Workflows.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/plan-writing .claude/skills/plan-writing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
plan-writing
GitHub stars
130
Used in
8 other repos
Token cost
~994 tokens
SKILL.md length
366 words
Files
1
Skills in repo
42
Repo updated
First seen
Licence
MIT

At a glance

Structured task planning with clear breakdowns, dependencies, and verification criteria.

  • Works in 4 steps: Small, Focused Tasks → Clear Verification → Logical Ordering → …
  • Implementing features
  • SKILL.md covers Overview, Task Breakdown Principles, Planning Principles (NOT… and Plan Structure (Flexible, Not…, plus 1 more section
  • Calls npx and npm

What it does

Plan Writing is an agent skill from xenitV1/Antigravity-Workflows. Structured task planning with clear breakdowns, dependencies, and verification criteria. Use when implementing features, refactoring, or any multi-step work.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Planning and Refactoring. The licence is MIT.

When your agent uses it

  • Implementing features
  • Any multi-step work

Example prompts

  • “/plan-writing”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Read, Glob, Grep

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Small, Focused Tasks
  2. Clear Verification
  3. Logical Ordering
  4. Dynamic Naming in Project Root

What it can do on your machine

Read from SKILL.md and the folder at commit f0a1fa7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Plan Writing loads about 994 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 366 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~994

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from xenitV1/Antigravity-Workflows at commit f0a1fa7, republished under its MIT licence (© xenitV1). 366 words, ~994 tokens.

Download SKILL.mdSave it as .claude/skills/plan-writing/SKILL.md (or your agent's skills folder).
name
plan-writing
description
Structured task planning with clear breakdowns, dependencies, and verification criteria. Use when implementing features, refactoring, or any multi-step work.
allowed-tools
Read, Glob, Grep

Plan Writing

Source: obra/superpowers

Overview

This skill provides a framework for breaking down work into clear, actionable tasks with verification criteria.

Task Breakdown Principles

1. Small, Focused Tasks
  • Each task should take 2-5 minutes
  • One clear outcome per task
  • Independently verifiable
2. Clear Verification
  • How do you know it's done?
  • What can you check/test?
  • What's the expected output?
3. Logical Ordering
  • Dependencies identified
  • Parallel work where possible
  • Critical path highlighted
  • Phase X: Verification is always LAST
4. Dynamic Naming in Project Root
  • Plan files are saved as {task-slug}.md in the PROJECT ROOT
  • Name derived from task (e.g., "add auth" → auth-feature.md)
  • NEVER inside .claude/, docs/, or temp folders

Planning Principles (NOT Templates!)

🔴 NO fixed templates. Each plan is UNIQUE to the task.

Principle 1: Keep It SHORT
❌ Wrong✅ Right
50 tasks with sub-sub-tasks5-10 clear tasks max
Every micro-step listedOnly actionable items
Verbose descriptionsOne-line per task

Rule: If plan is longer than 1 page, it's too long. Simplify.


Principle 2: Be SPECIFIC, Not Generic
❌ Wrong✅ Right
"Set up project""Run npx create-next-app"
"Add authentication""Install next-auth, create /api/auth/[...nextauth].ts"
"Style the UI""Add Tailwind classes to Header.tsx"

Rule: Each task should have a clear, verifiable outcome.


Show full SKILL.md (170 more words)Show less
Principle 3: Dynamic Content Based on Project Type

For NEW PROJECT:

  • What tech stack? (decide first)
  • What's the MVP? (minimal features)
  • What's the file structure?

For FEATURE ADDITION:

  • Which files are affected?
  • What dependencies needed?
  • How to verify it works?

For BUG FIX:

  • What's the root cause?
  • What file/line to change?
  • How to test the fix?

Principle 4: Scripts Are Project-Specific

🔴 DO NOT copy-paste script commands. Choose based on project type.

Project TypeRelevant Scripts
Frontend/Reactux_audit.py, accessibility_checker.py
Backend/APIapi_validator.py, security_scan.py
Mobilemobile_audit.py
Databaseschema_validator.py
Full-stackMix of above based on what you touched

Wrong: Adding all scripts to every plan Right: Only scripts relevant to THIS task


Principle 5: Verification is Simple
❌ Wrong✅ Right
"Verify the component works correctly""Run npm run dev, click button, see toast"
"Test the API""curl localhost:3000/api/users returns 200"
"Check styles""Open browser, verify dark mode toggle works"

Plan Structure (Flexible, Not Fixed!)

# [Task Name]

## Goal
One sentence: What are we building/fixing?

## Tasks
- [ ] Task 1: [Specific action] → Verify: [How to check]
- [ ] Task 2: [Specific action] → Verify: [How to check]
- [ ] Task 3: [Specific action] → Verify: [How to check]

## Done When
- [ ] [Main success criteria]

That's it. No phases, no sub-sections unless truly needed. Keep it minimal. Add complexity only when required.

Notes

[Any important considerations]


---

## Best Practices (Quick Reference)

1. **Start with goal** - What are we building/fixing?
2. **Max 10 tasks** - If more, break into multiple plans
3. **Each task verifiable** - Clear "done" criteria
4. **Project-specific** - No copy-paste templates
5. **Update as you go** - Mark `[x]` when complete

---

## When to Use

- New project from scratch
- Adding a feature
- Fixing a bug (if complex)
- Refactoring multiple files

© xenitV1, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/plan-writing of xenitV1/Antigravity-Workflows.

Open the folder on GitHubat commit f0a1fa7

Used in 8 other repositories

We found 17 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 8 other GitHub owners. This page covers the copy in xenitV1/Antigravity-Workflows, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Plan Writing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Plan Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plan Writing this skillxenitV1/Antigravity-Workflows1308 repos~994Automated safety check: PassMIT
Workflowbrianlovin/agent-config3771 repos~687Automated safety check: PassNone
Write Specdzhng/skills1k—~4.7kAutomated safety check: PassMIT
Evanflow Improve Architectureevanklem/evanflow418—~950Automated safety check: PassCustom licence
Improvefossasia/eventyay-interpretation1.6k10 repos~3.7kAutomated safety check: WarnMIT
Claude Code Clawdbotwin4r/claude-code-clawdbot-skill123—~2.5kAutomated safety check: WarnNone

Similar skills

  • Workflow

    brianlovin/agent-config

    Workflow orchestration for complex coding tasks. An agent skill from brianlovin/agent-config.

    377 GitHub starsUsed in 1 repo~687 tokens
    DevelopmentAuto-check passed
  • Write Spec

    dzhng/skills

    Break large features into independently verifiable, human-reviewable slices under a feature directory in specs/.

    1k GitHub stars~4.7k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Identify refactoring opportunities by surfacing architectural friction.

    418 GitHub stars~950 tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • Improve

    fossasia/eventyay-interpretation

    Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute.

    1.6k GitHub starsUsed in 10 repos~3.7k tokens
    Agent WorkflowsAuto-check: warnings
  • Claude Code Clawdbot

    win4r/claude-code-clawdbot-skill

    Run Claude Code (Anthropic) from this host via the claude CLI (Agent SDK) in headless mode (-p) for codebase analysis, refactors, test fixing, and structured output.

    123 GitHub stars~2.5k tokensUpdated 8 mo ago
    AI & LLM EngineeringAuto-check: warnings
  • One Three One Rule

    Tommy-yw/RunbookHermes

    Structured decision-making framework for technical proposals and trade-off analysis.

    546 GitHub starsUsed in 3 repos~1.3k tokens
    Agent WorkflowsAuto-check passed

More from xenitV1/Antigravity-Workflows

All 42 skills in this repo
  • Parallel Agents

    xenitV1/Antigravity-Workflows

    Native multi-agent orchestration using Claude Code's Agent Tool.

    130 GitHub starsUsed in 9 repos~1.3k tokens
    Auto-check passed
  • Mobile Design

    xenitV1/Antigravity-Workflows

    Mobile-first design thinking and decision-making for iOS and Android apps.

    130 GitHub starsUsed in 2 repos~3.7k tokens
    Auto-check: notes
  • Bash Linux

    xenitV1/Antigravity-Workflows

    Bash/Linux terminal patterns. An agent skill from xenitV1/Antigravity-Workflows.

    130 GitHub starsUsed in 8 repos~1k tokens
    Auto-check: notes
  • Performance Profiling

    xenitV1/Antigravity-Workflows

    Performance profiling principles. An agent skill from xenitV1/Antigravity-Workflows.

    130 GitHub starsUsed in 8 repos~772 tokens
    Auto-check: notes
  • Behavioral Modes

    xenitV1/Antigravity-Workflows

    AI operational modes (brainstorm, implement, debug, review, teach, ship, orchestrate).

    130 GitHub starsUsed in 7 repos~1.3k tokens
    Auto-check passed
  • I18n Localization

    xenitV1/Antigravity-Workflows

    Internationalization and localization patterns. An agent skill from xenitV1/Antigravity-Workflows.

    130 GitHub starsUsed in 7 repos~758 tokens
    Auto-check passed

Questions about Plan Writing

What does Plan Writing do?

Structured task planning with clear breakdowns, dependencies, and verification criteria. Plan Writing is an agent skill from xenitV1/Antigravity-Workflows. Structured task planning with clear breakdowns, dependencies, and verification criteria.

When should I use Plan Writing?

Plan Writing fits situations like: implementing features; any multi-step work.

How do I install Plan Writing in Claude Code?

Run `npx skills add xenitV1/Antigravity-Workflows --skill plan-writing -a claude-code`. Or copy the skill folder (skills/plan-writing in xenitV1/Antigravity-Workflows) into .claude/skills/plan-writing in your project. Claude Code loads it when a task matches its description.

How do I install Plan Writing in Codex?

Run `npx skills add xenitV1/Antigravity-Workflows --skill plan-writing -a codex`. Or copy the skill folder (skills/plan-writing in xenitV1/Antigravity-Workflows) into .agents/skills/plan-writing in your project. Codex loads it when a task matches its description.

Can I use Plan Writing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add xenitV1/Antigravity-Workflows --skill plan-writing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/plan-writing, .gemini/skills/plan-writing, .github/skills/plan-writing and .opencode/skills/plan-writing in your project.

What does Plan Writing need to run?

Going by SKILL.md and its folder, Plan Writing needs the command-line tools its instructions call (npx and npm). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Glob, Grep.

Does Plan Writing access the network?

SKILL.md contains no URLs. Its commands use npx and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Plan Writing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Plan Writing use?

Plan Writing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Plan Writing use?

About 994 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Plan Writing?

Skills that share tags, products or a category with Plan Writing: Workflow (brianlovin/agent-config, 377 stars), Write Spec (dzhng/skills, 1k stars), Evanflow Improve Architecture (evanklem/evanflow, 418 stars) and Improve (fossasia/eventyay-interpretation, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plan Writing?

xenitV1 (a GitHub user) maintains it in xenitV1/Antigravity-Workflows, which has 130 GitHub stars. The repository holds 42 skills in this directory. The repository was last updated on January 14, 2026.

Source: xenitV1/Antigravity-Workflows on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.