Agent skill

Plan

by ffroliva in ffroliva/gflow-cli

Creates a structured task-by-task implementation plan for a gflow-cli feature.

MITAuto-check passedAgent Workflows

Install Plan

skills CLI
$ npx skills add ffroliva/gflow-cli --skill plan -a claude-code

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

GitHub CLI
$ gh skill install ffroliva/gflow-cli plan --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/ffroliva/gflow-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/plan .claude/skills/plan && 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
GitHub stars
264
Token cost
~2k tokens
SKILL.md length
687 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Creates a structured task-by-task implementation plan for a gflow-cli feature.

  • Works in 5 steps: Gather inputs from context → Ask clarifying questions (only if not… → Decompose into tasks → …
  • Tasks that involve Requirements gathering
  • SKILL.md covers When to invoke, When not to invoke, Protocol and Output example (header only), plus 1 more section
  • Calls uv and git

What it does

Plan is an agent skill from ffroliva/gflow-cli. Creates a structured task-by-task implementation plan for a gflow-cli feature. Gathers predict/scenario context, asks ≤3 clarifying questions, decomposes the feature into atomic committable tasks with step and test checklists, and writes docs/superpowers/plans/<YYYY-MM-DD-<slug/PLAN.md. Invoke after /gflow:predict returns GO or CAUTION and /gflow:scenario output is available.

Its SKILL.md is about 2k 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 Agent Workflows, covering Requirements gathering, Planning and AI video generation. The repository describes itself as: Drive Google Flow from the command line: Veo video and Imagen images, scripted, batched and pipeline-ready. Ships an MCP server so coding agents can drive it too, giving you and… The licence is MIT.

When your agent uses it

  • Tasks that involve Requirements gathering
  • Tasks that involve Planning
  • Tasks that involve AI video generation

Example prompts

  • “Use the plan skill to create a structured task-by-task implementation plan for a gflow-cli feature”
  • “/plan”

Requirements

  • Python 3

Workflow steps

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

  1. Gather inputs from context
  2. Ask clarifying questions (only if not answerable from context)
  3. Decompose into tasks
  4. Draft the plan and show it to the user
  5. Write the file

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • git

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

  • Network

    No URLs in SKILL.md. Its commands use uv and git, 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 loads about 2k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 687 words of instructions outside code blocks.

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

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 ffroliva/gflow-cli at commit cb6d501, republished under its MIT licence (© ffroliva). 687 words, ~1,995 tokens.

Download SKILL.mdSave it as .claude/skills/plan/SKILL.md (or your agent's skills folder).
name
plan
description
Creates a structured task-by-task implementation plan for a gflow-cli feature. Gathers predict/scenario context, asks ≤3 clarifying questions, decomposes the feature into atomic committable tasks with step and test checklists, and writes docs/superpowers/plans/<YYYY-MM-DD>-<slug>/PLAN.md. Invoke after /gflow:predict returns GO or CAUTION and /gflow:scenario output is available.
version
1.0

plan — Feature Plan Creator

Turns a feature description into a task-by-task implementation plan and writes it to docs/superpowers/plans/<YYYY-MM-DD>-<feature-slug>/PLAN.md.

Position in the gflow-cli workflow:

/gflow:predict <proposal>   →  GO / CAUTION / STOP verdict
/gflow:scenario <feature>   →  edge cases + BDD skeleton
/gflow:plan <feature>       →  writes the task checklist  ← this skill
/gflow:status               →  surfaces next task during execution
/gflow:check                →  before each commit

When to invoke

  • After /gflow:predict returns GO or CAUTION
  • When a backlog item in PLAN.md needs a concrete task breakdown before starting work
  • Any feature larger than a single isolated file change

When not to invoke

  • Simple bug fixes (< 10 lines, no boundary crossing) — go straight to the fix
  • Pure doc changes
  • A task already fully specified in a superpowers plan — use /gflow:status to find it

Protocol

Phase 1 — Gather inputs from context

From /gflow:predict output in context (do not ask if already present):

  • Verdict (GO / CAUTION) and confidence score
  • Architectural constraints and module placement
  • Security risks and mandatory mitigations
  • Devil's Advocate simplifications or sequencing blockers

From /gflow:scenario output in context (do not ask if already present):

  • Critical and High scenarios → these become must-cover tests in the task checklist
  • BDD Scenario: blocks → seeds the BDD scaffold task

From the feature description passed to this skill:

  • Feature name → derive a slug (lowercase, hyphen-separated, no dates)
  • Stated goal (one sentence)

From the repo — run once:

bash
uv run python scripts/dev/active_plan.py

Note the active phase name and its open tasks. Then read PLAN.md § "Phase status" and § "Decision log" directly to verify the proposed feature is within current scope and does not contradict an existing ADR. (The script shows the current task, not a backlog index — use PLAN.md for scope confirmation.)

Phase 2 — Ask clarifying questions (only if not answerable from context)

Ask at most 3. Focus on decisions that materially change the task breakdown:

  1. Scope boundary — what is explicitly out of scope for this plan?
  2. Module ownership — which existing module does this extend, or is a new module justified?
  3. Acceptance criteria — what does "done" look like from the user's perspective (command output, exit code, log event)?

Skip any question already answered by predict/scenario output or the feature description.

Show full SKILL.md (371 more words)Show less
Phase 3 — Decompose into tasks

Task rules:

  • Each task must be independently committable as one atomic git commit.
  • Test scaffold tasks (red tests, BDD skeleton) come before the code that makes them green.
  • Tasks that create new files come before tasks that modify callers.
  • Derive test requirements from scenario output: Critical → must-cover (- [ ]), High → should-cover.
  • Every task lists: what it does, which files change, step checklist, test checklist.

Typical task order for a gflow-cli feature:

#TaskNotes
1Unit test scaffoldRed tests only. No production code.
2BDD scaffoldRed BDD scenarios. No production code.
3Core implementationDomain objects / value types / parsers.
4Transport / API layerFlowApiClient or UiAutomationTransport changes.
5CLI surfacecli_*.py + Click commands + --help text.
6MCP surface mirrorNever optional when task 5 exists. mcp/tools.py signature + docstring claims, the queued-path payload keys in worker/codec.py, tests/mcp/test_cli_parity.py for a new leaf.
7Docs updateUSAGE.md, CONFIGURATION.md (new env vars), docs/MCP.md, KNOWN_ISSUES.md if relevant.
8Full gates + release prep/gflow:check green; CHANGELOG updated.

Adjust: not every task applies to every feature. Merge or split tasks as the scope demands — except task 6. If the plan has a task 5, it has a task 6, because gflow ships every capability twice and the automated gates cannot see the two drifting apart. A plan that touches the CLI and has no MCP task is incomplete, not lean. The mirror axes are enumerated once, in skills/check/SKILL.md step 1b; cite them, do not copy them.

Phase 4 — Draft the plan and show it to the user

Produce the full PLAN.md content using this schema:

markdown
# <Feature Display Name> Implementation Plan

> **For agentic workers:** Run `/gflow:status --feature <slug>` to find the next
> unchecked task. Implement one task at a time. Run `/gflow:check` before every commit.

**Goal:** <one sentence — the user-visible outcome>

**Architecture:** <2–3 sentences — which modules change, key design decisions, what stays the same>

**Predict verdict:** <GO / CAUTION — confidence N/10> (or "pending — run /gflow:predict first")

**Risk register:**
| Severity | Risk | Mitigation |
|---|---|---|
| (from predict output) | | |

---

## File structure

### New files
\`\`\`
src/gflow_cli/<module>.py
  <one-line description>
tests/<module>/test_<module>.py
  <one-line description>
\`\`\`

### Modified files
\`\`\`
src/gflow_cli/<existing>.py
  <what changes>
\`\`\`

---

## Task 1 — <name> (test scaffold)

**What:** <one sentence>

**Files:**
- `tests/...` — <description>

**Steps:**
- [ ] <step>

**Tests created (red):**
- [ ] <test name> — <what it asserts>

---

## Task 2 — ...

(repeat for each task)

---

## Definition of done

- [ ] All task steps checked off
- [ ] `/gflow:check` green (ruff / format / pyright / pytest ≥ 80% coverage)
- [ ] `CHANGELOG.md` `[Unreleased]` section updated
- [ ] Docs updated (`USAGE.md` / `CONFIGURATION.md` as applicable)
- [ ] BDD feature file covers all Critical + High scenarios from `/gflow:scenario`
- [ ] No `# TODO` in diff without a tracked issue link

Show the drafted plan to the user. If they approve (or say "write it"), proceed to Phase 5.

Phase 5 — Write the file
bash
mkdir -p docs/superpowers/plans/<YYYY-MM-DD>-<slug>

Write the plan to docs/superpowers/plans/<YYYY-MM-DD>-<slug>/PLAN.md.

Confirm with:

Plan written to docs/superpowers/plans/<YYYY-MM-DD>-<slug>/PLAN.md. Run /gflow:status --feature <slug> to start working on it.


Output example (header only)

# Batch Manifest Ledger Implementation Plan

> **For agentic workers:** Run `/gflow:status --feature batch-manifest-ledger` to
> find the next unchecked task. Implement one task at a time. Run `/gflow:check`
> before every commit.

**Goal:** Add a local SQLite ledger to `gflow video batch` so interrupted runs skip
already-completed items on resume.

**Predict verdict:** GO — confidence 8/10

**Risk register:**
| Severity | Risk | Mitigation |
|---|---|---|
| High | Schema migration on user's existing DB | Checksummed migration runner (already in data/) |
| Medium | Ledger path drift between runs | Normalize to absolute path at record time |

Integration & Pipeline Continuation (Next Step Handoff)

  • Claude Code: invoke via /gflow:plan <feature> (thin wrapper around this skill).
  • Cursor / Aider / Codex: paste this file into your context and call plan <feature>.
  • Antigravity (agy): include in system context before asking for a plan.
  • Next step: Upon completing and user-approving PLAN.md, proactively announce: "Implementation Plan approved. Next step: Phase 6 Task Execution (/gflow:status --feature <slug>)."

© ffroliva, 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 of ffroliva/gflow-cli.

Open the folder on GitHubat commit cb6d501

Compare with similar skills

Plan 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plan this skillffroliva/gflow-cli264—~2kAutomated safety check: PassMIT
Interview Meaddyosmani/agent-skills103k6 repos~3.8kAutomated safety check: PassMIT
Brainstorming Before BuildingjnMetaCode/superpowers-zh8.3k—~1.8kAutomated safety check: PassMIT
ULW Plan Workflowcode-yeongyu/oh-my-openagent70k—~3.9kAutomated safety check: PassCustom licence
CE BrainstormEveryInc/compound-engineering-plugin25k—~1.9kAutomated safety check: PassMIT
Ask NavigatorYeachan-Heo/oh-my-claudecode40k—~4.1kAutomated safety check: PassMIT

Similar skills

  • Interview Me

    addyosmani/agent-skills

    Asks one question at a time, each with a best guess attached, until the agent is about 95 percent sure what you really want, before any plan, spec or code.

    103k GitHub starsUsed in 6 repos~3.8k tokens
    Agent WorkflowsAuto-check passed
  • Brainstorming Before Building

    jnMetaCode/superpowers-zh

    Turns a rough idea into an approved design before any code is written, sorting the request into spike, bounded or architectural and enforcing an approval gate.

    8.3k GitHub stars~1.8k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • ULW Plan Workflow

    code-yeongyu/oh-my-openagent

    Explore-first planning that turns a vague or large request into one decision-complete work plan, written only after your approval and executed by a separate worker.

    70k GitHub stars~3.9k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • CE Brainstorm

    EveryInc/compound-engineering-plugin

    Turns a vague or ambitious feature idea into a requirements-only plan through dialogue with you, sized to the work, before any code is written.

    25k GitHub stars~1.9k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Ask Navigator

    Yeachan-Heo/oh-my-claudecode

    Charts a foggy effort into a map of decision tickets on the repo's issue tracker and works through them one per session, producing decisions rather than deliverables.

    40k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Grill With UI

    jasonku09/grill-with-ui

    Moves a design-grilling interview from the terminal to a local web page, where each question, recommendation and discussion thread can be handled in any order.

    250 GitHub stars~7.9k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed

More from ffroliva/gflow-cli

All 17 skills in this repo
  • Gflow CLI

    ffroliva/gflow-cli

    A skill your agent uses when the user wants to drive Google Flow (Veo image-to-video, Veo text-to-video, Imagen / Nano Banana image generation) from the terminal or a script — including…

    264 GitHub stars~4.8k tokensUpdated today
    Auto-check: notes
  • Issue Assessment

    ffroliva/gflow-cli

    A skill your agent uses when triaging a GitHub issue for gflow-cli — a reporter's bug claim, a freshly-filed issue, or deciding whether and how to act on one.

    264 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Issue Resolve

    ffroliva/gflow-cli

    A skill your agent uses when an assessed gflow-cli issue (verdict CONFIRMED-BUG or LIKELY-BUG) has localized, verifiable scope and should be driven to a fix.

    264 GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Live Verify

    ffroliva/gflow-cli

    Two-part gate for gflow-cli feature/fix work. An agent skill from ffroliva/gflow-cli.

    264 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Video Production

    ffroliva/gflow-cli

    A skill your agent uses when the user wants a finished video out of gflow rather than a single clip — a scripted scene, a talking-head or dialogue piece, an explainer, a product montage, a story…

    264 GitHub stars~7k tokensUpdated today
    Auto-check passed
  • Check

    ffroliva/gflow-cli

    Auto-fix lint and formatting, then report types and tests. An agent skill from ffroliva/gflow-cli.

    264 GitHub stars~2.6k tokensUpdated today
    Auto-check passed

Categories

Questions about Plan

What does Plan do?

Creates a structured task-by-task implementation plan for a gflow-cli feature. Plan is an agent skill from ffroliva/gflow-cli. Creates a structured task-by-task implementation plan for a gflow-cli feature.

When should I use Plan?

Plan fits situations like: tasks that involve Requirements gathering; tasks that involve Planning; tasks that involve AI video generation.

How do I install Plan in Claude Code?

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

How do I install Plan in Codex?

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

Can I use Plan 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 ffroliva/gflow-cli --skill plan -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, .gemini/skills/plan, .github/skills/plan and .opencode/skills/plan in your project.

What does Plan need to run?

Going by SKILL.md and its folder, Plan needs the command-line tools its instructions call (uv and git). Our summary lists: Python 3.

Does Plan access the network?

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

Is Plan 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 use?

Plan 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 use?

About 2k tokens (SKILL.md is roughly 8k 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?

Skills that share tags, products or a category with Plan: Interview Me (addyosmani/agent-skills, 103k stars), Brainstorming Before Building (jnMetaCode/superpowers-zh, 8.3k stars), ULW Plan Workflow (code-yeongyu/oh-my-openagent, 70k stars) and CE Brainstorm (EveryInc/compound-engineering-plugin, 25k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plan?

ffroliva (a GitHub user) maintains it in ffroliva/gflow-cli, which has 264 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 7, 2026.

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