Agent skill

Verify Spectre

by joenandez in joenandez/spectre

A skill your agent uses when validating that the Spectre plugin itself still works after ANY change to this repo — skills, prompts, agents, hooks, the CLI, the Codex mirror, or a release.

MITAuto-check passedProduct & Project Management

Install Verify Spectre

skills CLI
$ npx skills add joenandez/spectre --skill verify-spectre -a claude-code

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

GitHub CLI
$ gh skill install joenandez/spectre verify-spectre --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/joenandez/spectre.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/verify-spectre .claude/skills/verify-spectre && 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
verify-spectre
GitHub stars
164
Token cost
~1.5k tokens
SKILL.md length
708 words
Files
8 (incl. scripts, references)
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when validating that the Spectre plugin itself still works after ANY change to this repo — skills, prompts, agents, hooks, the CLI, the Codex mirror, or a release.

  • Validating that the Spectre plugin itself still works after ANY change to this repo — skills
  • SKILL.md covers Run it, The gates, Why gate 4 is the one that… and Maintaining the suite
  • Runs JavaScript scripts from its folder; calls node and npm
  • The Codex mirror

What it does

Verify Spectre is an agent skill from joenandez/spectre. Use when validating that the Spectre plugin itself still works after ANY change to this repo — skills, prompts, agents, hooks, the CLI, the Codex mirror, or a release. Runs the full gate suite (structure, tests, Codex translation, real-CLI behavior, release readiness) and reports PASS/FAIL per gate. Trigger on: verify, validate, does this still work, check the plugin, pre-commit check, pre-release check, did I break anything, is the Codex mirror stale, ready to publish. Do NOT trigger for validating a user's own…

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files.

It sits in Product & Project Management, covering Feature launches and release readiness and Translation. The repository describes itself as: Spectre is a battle-tested 6 stage agentic engineering workflow for building complex, production-ready features. You stay in the loop for the decisions that matter. Your agents…. The licence is MIT.

When your agent uses it

  • Validating that the Spectre plugin itself still works after ANY change to this repo — skills
  • The Codex mirror
  • Does this still work
  • Check the plugin

Example prompts

  • “/verify-spectre”

Requirements

  • Node.js

What it can do on your machine

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

    Ships 6 files in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use 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

Verify Spectre loads about 1.5k tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 145 tokens; SKILL.md has 708 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from joenandez/spectre at commit 931c9e8, republished under its MIT licence (© joenandez). 708 words, ~1,523 tokens.

Download SKILL.mdSave it as .claude/skills/verify-spectre/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
verify-spectre
description
Use when validating that the Spectre plugin itself still works after ANY change to this repo — skills, prompts, agents, hooks, the CLI, the Codex mirror, or a release. Runs the full gate suite (structure, tests, Codex translation, real-CLI behavior, release readiness) and reports PASS/FAIL per gate. Trigger on: verify, validate, does this still work, check the plugin, pre-commit check, pre-release check, did I break anything, is the Codex mirror stale, ready to publish. Do NOT trigger for validating a user's own project — this validates the spectre codebase.
user-invocable
true

verify-spectre

The gate suite for the Spectre plugin itself. Run it after any change to skills, agents, hooks, src/lib/, or the Codex mirror — and always before a release.

The reason this exists as scripts rather than a checklist: Spectre's real failures are silent. A skill whose frontmatter name drifts from its directory never triggers. A stale Codex mirror serves every Codex user the previous version indefinitely. A missing SessionStart registry or exact-load path leaves project knowledge undiscoverable without blocking the user's work. None of these break a test or throw an error — they just quietly stop working. So every check asserts an observable condition (file contents, exit code, byte-comparison) and exits nonzero. Nothing here is eyeballed.

Run it

bash
node .agents/skills/verify-spectre/scripts/verify.mjs            # gates 1-4 (default, pre-commit)
node .agents/skills/verify-spectre/scripts/verify.mjs --fast     # gates 1-2 (seconds, on every change)
node .agents/skills/verify-spectre/scripts/verify.mjs --release  # gates 1-5 (before publishing)
node .agents/skills/verify-spectre/scripts/verify.mjs --gate 4   # one gate, when iterating on a fix

The scripts live alongside this skill under .agents/skills/verify-spectre/scripts/ and are the single canonical copy tracked by the public repository. Keeping the executable gates beside the skill makes a fresh clone independently verifiable without relying on ignored .claude/ state.

Run from the repo root. The scripts locate the repo from their own path, so they work regardless of your working directory.

Report the PASS/FAIL summary. On failure, each check already names what was expected and what was found — quote that rather than re-deriving it.

The gates

#GateAsserts
1structureSkill/agent frontmatter valid and name matches its directory · expected-skills manifest intact · hooks.json parses, scripts exist, SessionStart order is bootstrap → handoff-resume → load-knowledge · no active skill contains {{REGISTRY}} · no stale fork naming · every Skill(spectre-x) / /spectre:spectre-x / @spectre:agent reference resolves · four canonical version files agree
2testsnpm test passes; reports the test count so a silent drop (deleted tests, not fixed ones) is visible
3codexsync-codex --check is clean — the committed mirror matches canonical source · generated hooks reference .mjs, never .cjs, and every referenced script exists · user commands use $spectre:spectre-* and skill paths use .agents/skills/
4real-cliThe CLI and hooks actually run, in throwaway temp dirs with a fresh CODEX_HOME (see below)
5releaseClean tree · mirror in sync · versions in lockstep · tag free · GitHub authenticated
Show full SKILL.md (376 more words)Show less

Why gate 4 is the one that counts

Tests exercise functions; users exercise the installed CLI and the hooks that fire at session start. Those are different things, and the gap between them is where this project's actual bugs have lived. Gate 4 closes it by driving the real binary:

  • Non-spectre guard — a bare directory gets nothing written to it.
  • Metadata-only registry delivery — Claude Code and Codex receive one size-bounded SessionStart registry on startup/resume/clear/compact, with complete routing entries and no record body or knowledge systemMessage.
  • Relevance policy — registry text requires both task-subject and use-condition alignment; an activation cue alone is insufficient.
  • Overflow recovery — an omitted active record remains discoverable through neutral lexical search and is applied only after a verified exact-ID load.
  • Load and resource contract — exact load returns the verified core plus canonical recordDirectory and safe resources paths, and one invocation advances successful-load activity exactly once.
  • Evidence separation — registry exposure is a delivery diagnostic; search match/miss is discovery evidence; a successful verified exact-ID load is authoritative content access and the sole registry-rank signal.
  • Session memory — a seeded handoff is surfaced by handoff-resume.
  • Retired installer hard cut — install/update/uninstall codex return CODEX_PLUGIN_REQUIRED and do not mutate files.
  • Native Codex plugin bootstrap — generated plugin hooks install/update/remove managed spectre_* agents, reject unowned collisions, remove legacy direct-install runtime, and doctor codex reports native readiness.

Transcript file-read evidence may inform a later curation review, but it is optional secondary evidence and never changes runtime registry rank.

If gate 4 can't run safely (no codex binary, sandbox restrictions), say so and stop — don't substitute the test suite for it and call the work validated. A green gate 2 with a skipped gate 4 means the functions work and the product is unverified.

Maintaining the suite

references/expected-skills.txt (alongside the scripts) is the skill manifest. Skills get added and removed on purpose, never by accident, so gate 1 fails on any drift — update the manifest in the same commit as the skill change. That's the check that catches a skill silently lost in a merge or refactor.

When you add a new invariant to the plugin, add its check to the gate it belongs to. A check that lives in a script runs every time; a check that lives in someone's memory runs once.

© joenandez, 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 7 other files (scripts, references) in .agents/skills/verify-spectre of joenandez/spectre.

  • SKILL.md
  • references/expected-skills.txt
  • scripts/gate1_structure.mjs
  • scripts/gate3_codex.mjs
  • scripts/gate4_cli.mjs
  • scripts/gate5_release.mjs
  • scripts/lib.mjs
  • scripts/verify.mjs

Open the folder on GitHubat commit 931c9e8

Compare with similar skills

Verify Spectre 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.

Verify Spectre compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Verify Spectre this skilljoenandez/spectre164—~1.5kAutomated safety check: PassMIT
Sealeap Amazon New Product Launch Planxjli360/sealeap-amazon-skills251—~548Automated safety check: PassMIT
Roam Release ReadinessCranot/roam-code517—~1.7kAutomated safety check: PassApache-2.0
Feature Launch Playbookgooseworks-ai/goose-skills1.2k1 repos~1.8kAutomated safety check: PassMIT
Operating System Visualizationmingchen666/Reviva244—~1.2kAutomated safety check: PassNone
Strategizeghaida/intent207—~6.1kAutomated safety check: PassCC0-1.0

Similar skills

  • Sealeap Amazon New Product Launch Plan

    xjli360/sealeap-amazon-skills

    Create a quantified Amazon new-product launch plan by translating a sales target into comparable-product benchmarks, keyword economics, budget scenarios, milestones, and stop-loss rules.

    251 GitHub stars~548 tokensUpdated 13 days ago
    Product & Project ManagementAuto-check passed
  • Roam Release Readiness

    Cranot/roam-code

    Qualify a Roam commit or accumulated batch for package, website, or server publication; reconcile source, tests, review, CI and deployed identities, and identify the next authorized release step.

    517 GitHub stars~1.7k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Feature Launch Playbook

    gooseworks-ai/goose-skills

    Take a new feature or product update and generate the full launch kit: changelog entry, email announcement, LinkedIn post variants, in-app banner text, Twitter/X thread, and internal sales…

    1.2k GitHub starsUsed in 1 repo~1.8k tokens
    Product & Project ManagementAuto-check passed
  • A skill your agent uses whenever the user wants visual learning for operating systems, process states, CPU scheduling, Gantt charts, synchronization, semaphore/PV problems, deadlock, Banker's…

    244 GitHub stars~1.2k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Strategize

    ghaida/intent

    Frames product design problems before solutions exist. An agent skill from ghaida/intent.

    207 GitHub stars~6.1k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • Official

    Produces evidence-backed ship-readiness verdicts for .NET MAUI Servicing Releases and Previews, and drafts public-safe release handoff pages from the result.

    23k GitHub stars~15k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from joenandez/spectre

All 26 skills in this repo
  • A skill your agent uses when modifying the Codex SPECTRE install flow, SessionStart continuity, project skill syncing, registry injection, or Codex-specific runtime files.

    164 GitHub stars~2.2k tokensUpdated 8 days ago
    Auto-check passed
  • Spectre Handoff

    joenandez/spectre

    Save a quiet, branch-keyed session snapshot with continuity, active work, and optional task/todo state for automatic resume.

    164 GitHub stars~1.3k tokensUpdated 8 days ago
    Auto-check passed
  • Spectre Learn

    joenandez/spectre

    User-invoked front door for durable capture. An agent skill from joenandez/spectre.

    164 GitHub stars~1k tokensUpdated 8 days ago
    Auto-check passed
  • Spectre Rewrite Skill

    joenandez/spectre

    Rewrite a verbose SPECTRE skill into a compact, contract-form Spectre skill proposal — clear on WHAT, silent on HOW — grounded in the spectre-light distillation and freedom-tier budget.

    164 GitHub stars~3k tokensUpdated 8 days ago
    Auto-check passed
  • Spectre Rewrite Subagent

    joenandez/spectre

    Rewrite Spectre subagent definitions into compact, contract-driven agents with clear routing, least-privilege tools, output schemas, and an auditable rewrite trail.

    164 GitHub stars~1.8k tokensUpdated 8 days ago
    Auto-check passed
  • Spectre Capture

    joenandez/spectre

    Capture durable project decisions, accepted corrections, verified reusable patterns or gotchas, disproved guidance, and changed persistent blockers as soon as they matter.

    164 GitHub stars~1.2k tokensUpdated 8 days ago
    Auto-check passed

Questions about Verify Spectre

What does Verify Spectre do?

A skill your agent uses when validating that the Spectre plugin itself still works after ANY change to this repo — skills, prompts, agents, hooks, the CLI, the Codex mirror, or a release. Verify Spectre is an agent skill from joenandez/spectre. Use when validating that the Spectre plugin itself still works after ANY change to this repo — skills, prompts, agents, hooks, the CLI, the Codex mirror, or a release.

When should I use Verify Spectre?

Verify Spectre fits situations like: validating that the Spectre plugin itself still works after ANY change to this repo — skills; the Codex mirror; does this still work; check the plugin.

How do I install Verify Spectre in Claude Code?

Run `npx skills add joenandez/spectre --skill verify-spectre -a claude-code`. Or copy the skill folder (.agents/skills/verify-spectre in joenandez/spectre) into .claude/skills/verify-spectre in your project. Claude Code loads it when a task matches its description.

How do I install Verify Spectre in Codex?

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

Can I use Verify Spectre 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 joenandez/spectre --skill verify-spectre -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/verify-spectre, .gemini/skills/verify-spectre, .github/skills/verify-spectre and .opencode/skills/verify-spectre in your project.

What does Verify Spectre need to run?

Going by SKILL.md and its folder, Verify Spectre needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node and npm). Our summary lists: Node.js.

Does Verify Spectre access the network?

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

Is Verify Spectre 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Verify Spectre use?

Verify Spectre 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 Verify Spectre use?

About 1.5k tokens (SKILL.md is roughly 6.1k 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 129 tokens, read only when the agent opens those files.

What are the alternatives to Verify Spectre?

Skills that share tags, products or a category with Verify Spectre: Sealeap Amazon New Product Launch Plan (xjli360/sealeap-amazon-skills, 251 stars), Roam Release Readiness (Cranot/roam-code, 517 stars), Feature Launch Playbook (gooseworks-ai/goose-skills, 1.2k stars) and Operating System Visualization (mingchen666/Reviva, 244 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Verify Spectre?

joenandez (a GitHub user) maintains it in joenandez/spectre, which has 164 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 2, 2026.

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