Agent skill

New Plan

by JayFarei in JayFarei/opentraces

Create a new plan document in kb/plans/ for the opentraces project.

Custom licenceAuto-check passedDevelopment

Install New Plan

skills CLI
$ npx skills add JayFarei/opentraces --skill new-plan -a claude-code

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

GitHub CLI
$ gh skill install JayFarei/opentraces new-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/JayFarei/opentraces.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/new-plan .claude/skills/new-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
new-plan
GitHub stars
100
Token cost
~2k tokens
SKILL.md length
954 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
Custom licence

At a glance

Create a new plan document in kb/plans/ for the opentraces project.

  • Works in 6 steps: Determine the next plan number → Quick intake → Classify and set initial fields → …
  • The user wants to capture a new feature idea
  • SKILL.md covers Step 1: Determine the next…, Step 2: Quick intake, Step 3: Classify and set… and Step 4: Flesh out the idea…, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

New Plan is an agent skill from JayFarei/opentraces. Create a new plan document in kb/plans/ for the opentraces project. Use this skill whenever the user wants to capture a new feature idea, operational task, bug fix, or refactor as a plan — even if they just say "let's plan X", "add a plan for Y", "write up a plan", "new plan", or describe an idea they want to backlog. The skill interviews the user to reach sufficient depth before writing, then produces a complete plan file following the project's established template and naming convention.

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 Development, covering Debugging and Refactoring. The repository describes itself as: A local-first evidence layer for agent work, capturing what the agent sees, does, and changes.

When your agent uses it

  • The user wants to capture a new feature idea
  • Operational task
  • Refactor as a plan — even if they just say lets plan X
  • Add a plan for Y

Example prompts

  • “s plan X”
  • “add a plan for Y”
  • “write up a plan”
  • “/new-plan”

Workflow steps

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

  1. Determine the next plan number
  2. Quick intake
  3. Classify and set initial fields
  4. Flesh out the idea with targeted questions
  5. Write the plan
  6. Confirm before writing

What it can do on your machine

Read from SKILL.md and the folder at commit 354755d. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml).

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

  • Network

    No URLs in SKILL.md.

    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

New Plan loads about 2k tokens when it runs. Until then it costs about 126 tokens; SKILL.md has 954 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~126
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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 954 words (~1,967 tokens).

“This skill creates a well-formed plan document in kb/plans/ by interviewing the user, fleshing out the idea to the depth we hold as standard across existing plans, then committing the file.”

— opening of SKILL.md by JayFarei, Custom licence
name
new-plan

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/new-plan of JayFarei/opentraces.

Open the folder on GitHubat commit 354755d

Compare with similar skills

New 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.

New Plan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
New Plan this skillJayFarei/opentraces100—~2kAutomated safety check: PassCustom licence
Code Review Graph Navigatorhandsontable/handsontable22k—~939Automated safety check: PassCustom licence
Analyze Projectlllllllama/RigorPilot-Skills4971 repos~519Automated safety check: PassMIT
Andrej Karpathy Skillduolahypercho/andrej-karpathy-skills249—~793Automated safety check: PassMIT
Verdaccio Change Implementationverdaccio/verdaccio18k—~1.3kAutomated safety check: PassMIT
RoamCranot/roam-code517—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • Code Review Graph Navigator

    handsontable/handsontable

    Queries a pre-built, Tree-sitter-based code graph of the whole monorepo instead of grepping call chains, for exploring, debugging, refactoring or reviewing code.

    22k GitHub stars~939 tokensUpdated today
    DevelopmentAuto-check passed
  • Analyze Project

    lllllllama/RigorPilot-Skills

    Rigor Analyze / Rigor Audit read-only skill for deep learning research repositories.

    497 GitHub starsUsed in 1 repo~519 tokens
    DevelopmentAuto-check passed
  • Andrej Karpathy Skill

    duolahypercho/andrej-karpathy-skills

    Apply Andrej Karpathy-inspired coding-agent guidelines in Codex.

    249 GitHub stars~793 tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • A workflow for implementing a Verdaccio bug fix, feature or refactor: pick the release lines, check existing options, edit the owning layer, test and add a changeset.

    18k GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Roam

    Cranot/roam-code

    Codebase comprehension via roam-code CLI. An agent skill from Cranot/roam-code.

    517 GitHub stars~2.4k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Odoo Workflow

    unclecatvn/agent-skills

    Mandatory pre-code gate and definition-of-done for ANY Odoo change (add field, override method, inherit view/xpath, OWL/JS patch, wizard, cron, controller, report, security, migration, bug fix…

    143 GitHub stars~4.7k tokensUpdated 15 days ago
    DevelopmentAuto-check passed

More from JayFarei/opentraces

All 13 skills in this repo
  • Opentraces Marketing

    JayFarei/opentraces

    Generate branded marketing screenshots of opentraces CLI commands — wordmark + CLI card + caption + wallpaper, filename-stamped and auto-copied to the clipboard.

    100 GitHub stars~2.3k tokensUpdated 3 days ago
    Auto-check passed
  • Docs Update

    JayFarei/opentraces

    Synchronize all documentation surfaces after code changes. An agent skill from JayFarei/opentraces.

    100 GitHub stars~4.6k tokensUpdated 3 days ago
    Auto-check passed
  • Deploy Site

    JayFarei/opentraces

    Land every site-related fix on main, deploy opentraces.ai to Vercel production, and verify it works across all pages (desktop + mobile) and the email-capture flow, fixing and re-deploying until green.

    100 GitHub stars~4.3k tokensUpdated 3 days ago
    Auto-check passed
  • Gitsync

    JayFarei/opentraces

    Sync both git repos in this project: opentraces (root) and closedtraces (kb/).

    100 GitHub stars~589 tokensUpdated 3 days ago
    Auto-check passed
  • PR Intent Summary V1

    JayFarei/opentraces

    Per-commit trace lineage rows for a branch context, deterministic.

    100 GitHub stars~534 tokensUpdated 3 days ago
    Auto-check passed
  • Derive compact eval rows from command-attributed trace trajectories.

    100 GitHub stars~681 tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about New Plan

What does New Plan do?

Create a new plan document in kb/plans/ for the opentraces project. New Plan is an agent skill from JayFarei/opentraces. Create a new plan document in kb/plans/ for the opentraces project.

When should I use New Plan?

New Plan fits situations like: the user wants to capture a new feature idea; operational task; refactor as a plan — even if they just say lets plan X; add a plan for Y.

How do I install New Plan in Claude Code?

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

How do I install New Plan in Codex?

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

Can I use New 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 JayFarei/opentraces --skill new-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/new-plan, .gemini/skills/new-plan, .github/skills/new-plan and .opencode/skills/new-plan in your project.

What does New Plan need to run?

SKILL.md names no scripts, command-line tools or credentials: New Plan is instructions for the agent only.

Does New Plan access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

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

New Plan has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does New Plan use?

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

Skills that share tags, products or a category with New Plan: Code Review Graph Navigator (handsontable/handsontable, 22k stars), Analyze Project (lllllllama/RigorPilot-Skills, 497 stars), Andrej Karpathy Skill (duolahypercho/andrej-karpathy-skills, 249 stars) and Verdaccio Change Implementation (verdaccio/verdaccio, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains New Plan?

JayFarei (a GitHub user) maintains it in JayFarei/opentraces, which has 100 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 6, 2026.

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