Agent skill

Grace Plan

by osovv in osovv/grace-marketplace

Read an approved GRACE 4 GraceChangeSpec and optional design context, then create a GraceChangePlan with assertions, scopes, tasks, and verification gates.

MITAuto-check passed

Install Grace Plan

skills CLI
$ npx skills add osovv/grace-marketplace --skill grace-plan -a claude-code

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

GitHub CLI
$ gh skill install osovv/grace-marketplace grace-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/osovv/grace-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/grace/grace-plan .claude/skills/grace-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
grace-plan
GitHub stars
251
Token cost
~977 tokens
SKILL.md length
448 words
Files
3 (incl. references)
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Read an approved GRACE 4 GraceChangeSpec and optional design context, then create a GraceChangePlan with assertions, scopes, tasks, and verification gates.

  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Grace Plan is an agent skill from osovv/grace-marketplace. Read an approved GRACE 4 GraceChangeSpec and optional design context, then create a GraceChangePlan with assertions, scopes, tasks, and verification gates.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml`).

The repository describes itself as: GRACE (Graph-RAG Anchored Code Engineering): open Agent Skills for contract-driven AI code generation with semantic markup, knowledge graphs, and support for Claude Code, Codex… The licence is MIT.

Example prompts

  • “/grace-plan”

What it can do on your machine

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

    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

Grace Plan loads about 977 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 42 tokens; SKILL.md has 448 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~977
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

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 osovv/grace-marketplace at commit 70f5ec4, republished under its MIT licence (© osovv). 448 words, ~977 tokens.

Download SKILL.mdSave it as .claude/skills/grace-plan/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
grace-plan
description
Read an approved GRACE 4 GraceChangeSpec and optional design context, then create a GraceChangePlan with assertions, scopes, tasks, and verification gates.
<skill>
<purpose>Convert one approved active `GraceChangeSpec` into the executable `GraceChangePlan`; do not implement source code.</purpose>
<inputs>
- Required: `.grace/changes/active/C-CHANGE-ID/spec.xml`
- Optional: sibling `design-context.xml`
- Current state: `.grace/context`, graph and verification indexes, and their routed documents
</inputs>

<preflight>

  • Require .grace/changes/active/C-CHANGE-ID/spec.xml with GraceChangeSpec, status approved, and exactly one matching direct C-* wrapper.
  • Refuse draft, rejected, cancelled, applied, or superseded specs.
  • Treat optional design-context.xml as explanatory; spec.xml wins on conflict.
  • Run grace lint --path PROJECT --assertions current before planning and surface stale or invalid active baselines. </preflight>

<approved_plan_immutability>

  • If plan.xml already exists with status approved, stop before writing.
  • Do not refresh BaselineAssertions, TargetAssertions, DurableScope, ObservedWriteScope, or tasks in place.
  • Create a new C-* bundle and mark the old bundle superseded with an explicit replacement reference. </approved_plan_immutability>

<must_do> Produce plan.xml from references/change-plan-template.xml as draft unless the user explicitly approves the completed plan. Require a matching C-* wrapper, meaningful intent, non-empty machine-checkable baseline and target assertions, explicit durable and observed scopes, and unique acyclic T-NNN tasks. A scope with no writes must use an explicit <None /> marker; prose such as "none" is invalid. Every task has one Title, one DependsOn element listing zero or more predecessors as canonical comma-separated T-NNN values (for example <DependsOn>T-001, T-002</DependsOn>), non-empty acceptance criteria, and non-empty verification commands. Dependencies form a directed acyclic graph: list only true predecessors and never linearize independent tasks into a chain to express ordering. Surface stale-state and coexistence warnings, and reject unsupported scope glob syntax instead of guessing. </must_do>

<command_phase_rules>

  • current is an active-baseline preflight and is valid only before observed writes begin.
  • baseline is the selected pre-edit gate, target is selected post-edit evidence, and final is the outer apply/archive gate owned by grace-execute.
  • MustPassCommand contains leaf project evidence such as tests, typecheck, build, format, or package checks. Never place grace lint, grace status, or another GRACE lifecycle command inside it.
  • Never put --assertions current in TargetAssertions or in task verification that runs after writes. Use selected target/final lint externally instead.
  • A MustPassCommand must complete within its declared budgetSeconds (absent, the global --command-timeout applies) on the reference host; declare the budget you have measured rather than inheriting a default that will kill the command mid-gate.
  • A whole-suite command whose runtime is dominated by substrate startup — containers, databases, browsers, emulators — belongs in an acceptance tier, not in the gate; never declare both a whole-suite command and the file-level commands it already re-runs. </command_phase_rules>
Show full SKILL.md (55 more words)Show less
<validation>
- Active-baseline preflight: `grace lint --path PROJECT --assertions current`
- Parallel safety: `grace lint --path PROJECT --parallel-preflight`
- Recommend `grace status --path PROJECT --json` after approval.
</validation>

<hard_rules> Do not implement code, silently approve a plan, overwrite an approved plan, or mutate current graph/verification artifacts while planning. Semantic anchors are canonical XML tags, never attributes. </hard_rules> </skill>

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

Files

SKILL.md and 2 other files (references) in skills/grace/grace-plan of osovv/grace-marketplace.

  • SKILL.md
  • agents/openai.yaml
  • references/change-plan-template.xml

Open the folder on GitHubat commit 70f5ec4

Compare with similar skills

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

Grace Plan compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Grace Plan this skillosovv/grace-marketplace251—~977Automated safety check: PassMIT
Optionsasgeirtj/system_prompts_leaks69k—~918Automated safety check: PassCC0-1.0
Operator Approval Loopaffaan-m/ECC276k—~3.3kAutomated safety check: PassMIT
Graceful Shutdownsickn33/agentic-awesome-skills47k1 repos~3.5kAutomated safety check: PassMIT
Options Strategy BacktestingHKUDS/Vibe-Trading35k—~2kAutomated safety check: PassMIT
Remove Option Or Flaggetsentry/sentry46k—~3kAutomated safety check: PassCustom licence

Similar skills

  • Options

    asgeirtj/system_prompts_leaks

    Present multiple design options as a vertical stack of anchored turns

    69k GitHub stars~918 tokensUpdated yesterday
    Auto-check passed
  • Operator approval contract with internal filing notices for agent-drafted outbound messages, hashed drafts, epoch-keyed decisions, durable delivery claims and receipts, and a pre-draft baseline gate.

    276k GitHub stars~3.3k tokensUpdated 4 days ago
    Auto-check passed
  • Graceful Shutdown

    sickn33/agentic-awesome-skills

    Implement graceful shutdown for servers and workers: drain connections, finish in-flight work, release resources, and exit cleanly on SIGTERM/SIGINT.

    47k GitHub starsUsed in 1 repo~3.5k tokens
    DevOps & CloudAuto-check passed
  • Backtests multi-leg option strategies by synthesizing Black-Scholes prices from the underlying, simulating PnL, Greeks exposure and expiration for crypto and equity options.

    35k GitHub stars~2k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Remove Option Or Flag

    getsentry/sentry

    Official

    Remove a Sentry option or FlagPole feature flag whose rollout is finished, in the correct PR order across sentry, getsentry, and sentry-options-automator.

    46k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Options Payoff

    HKUDS/Vibe-Trading

    Option P&L analysis methodology: payoff diagrams, breakeven calculation, multi-leg strategy visualization, and Greeks-based scenario analysis.

    35k GitHub stars~6.8k tokensUpdated today
    Business, Finance & HRAuto-check passed

More from osovv/grace-marketplace

All 10 skills in this repo
  • Grace Migrate

    osovv/grace-marketplace

    Agent-applied GRACE 3 to GRACE 4 migration workflow. An agent skill from osovv/grace-marketplace.

    251 GitHub stars~706 tokensUpdated 15 days ago
    Auto-check passed
  • Grace Spec

    osovv/grace-marketplace

    Interview the user and create an approved GRACE 4 GraceChangeSpec plus optional design-context.xml inside .grace/changes/active/C-/.

    251 GitHub stars~545 tokensUpdated 15 days ago
    Auto-check passed
  • Grace Init

    osovv/grace-marketplace

    Bootstrap a Full GRACE 4 project by creating the canonical .grace context, graph, verification, and changes skeleton.

    251 GitHub stars~745 tokensUpdated 15 days ago
    Auto-check passed
  • Grace CLI

    osovv/grace-marketplace

    Operate the GRACE 4 CLI for .grace linting, status, module navigation, verification navigation, and file-local semantic markup.

    251 GitHub stars~1k tokensUpdated 15 days ago
    Auto-check passed
  • Grace Execute

    osovv/grace-marketplace

    Execute an approved GRACE 4 GraceChangePlan in sequential or parallel-safe mode with recovery-aware preflight and centralized durable apply.

    251 GitHub stars~838 tokensUpdated 15 days ago
    Auto-check passed
  • Grace Explainer

    osovv/grace-marketplace

    Explain GRACE 4 methodology, .grace artifacts, semantic anchors, change lifecycle, verification, and migration boundaries.

    251 GitHub stars~298 tokensUpdated 15 days ago
    Auto-check passed

Questions about Grace Plan

What does Grace Plan do?

Read an approved GRACE 4 GraceChangeSpec and optional design context, then create a GraceChangePlan with assertions, scopes, tasks, and verification gates. Grace Plan is an agent skill from osovv/grace-marketplace. Read an approved GRACE 4 GraceChangeSpec and optional design context, then create a GraceChangePlan with assertions, scopes, tasks, and verification gates.

How do I install Grace Plan in Claude Code?

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

How do I install Grace Plan in Codex?

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

Can I use Grace 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 osovv/grace-marketplace --skill grace-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/grace-plan, .gemini/skills/grace-plan, .github/skills/grace-plan and .opencode/skills/grace-plan in your project.

What does Grace Plan need to run?

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

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

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

About 977 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 353 tokens, read only when the agent opens those files.

What are the alternatives to Grace Plan?

Skills that share tags, products or a category with Grace Plan: Options (asgeirtj/system_prompts_leaks, 69k stars), Operator Approval Loop (affaan-m/ECC, 276k stars), Graceful Shutdown (sickn33/agentic-awesome-skills, 47k stars) and Options Strategy Backtesting (HKUDS/Vibe-Trading, 35k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Grace Plan?

osovv (a GitHub user) maintains it in osovv/grace-marketplace, which has 251 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 24, 2026.

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