Agent skill

Spectre Learn

by joenandez in joenandez/spectre

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

MITAuto-check passed

Install Spectre Learn

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

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

GitHub CLI
$ gh skill install joenandez/spectre spectre-learn --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/plugins/spectre/skills/spectre-learn .claude/skills/spectre-learn && 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
spectre-learn
GitHub stars
164
Token cost
~1k tokens
SKILL.md length
437 words
Files
3 (incl. scripts)
Skills in repo
26
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 3 steps: Identify intent from the request. A bare… → For an insight or correction, provide… → The knowledge skill reads…
  • The user invokes /learn
  • SKILL.md covers Purpose, Inputs, Working Set and Outputs + DONE, plus 3 more sections
  • Runs JavaScript scripts from its folder

What it does

Spectre Learn is an agent skill from joenandez/spectre. User-invoked front door for durable capture. Use when the user invokes /learn or asks to remember, correct, preserve, or summarize consequential project work; interpret the request and delegate persistence to Capture. Do not use for autonomous capture, routine progress, unsupported hypotheses, personal preferences, or knowledge lookup.

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

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

  • The user invokes /learn
  • Asks to remember
  • Summarize consequential project work
  • Interpret the request and delegate persistence to Capture

Example prompts

  • “/spectre-learn”

Requirements

  • Node.js

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Identify intent from the request. A bare request scans the conversation for accepted consequential decisions, verified reusable…
  2. For an insight or correction, provide Skill(spectre-capture) the evidence, authority, and maintained-knowledge target. For an explicit…
  3. The knowledge skill reads ${CLAUDE_PLUGIN_ROOT}/skills/spectre-capture/references/knowledge-capture-input.json; the work-record skill…

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 2 files in scripts/ (JavaScript), which the agent can run.

    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

Spectre Learn loads about 1k tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 437 words of instructions outside code blocks.

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

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). 437 words, ~1,002 tokens.

Download SKILL.mdSave it as .claude/skills/spectre-learn/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
spectre-learn
description
User-invoked front door for durable capture. Use when the user invokes /learn or asks to remember, correct, preserve, or summarize consequential project work; interpret the request and delegate persistence to Capture. Do not use for autonomous capture, routine progress, unsupported hypotheses, personal preferences, or knowledge lookup.
user-invocable
true
disable-model-invocation
true

learn

Purpose

Turn an explicit user capture request into maintained knowledge or a historical work-record request. Learn owns user intent and routing; Skill(spectre-capture) owns knowledge persistence and Skill(spectre-work-record) owns work history. Do not revive knowledge-skill authoring, proposal gates, dossiers, or SessionStart output.

Inputs

  • An explicit user capture request, $ARGUMENTS, and the current conversation; bare invocation means review the conversation for consequential, evidenced knowledge.
  • User intent: an insight or correction targets maintained knowledge; a work summary, explicit snapshot, or historical correction targets a typed work record.
  • The current project directory and any exact record/work identity already in context. A Spectre feature root is not required.

Working Set

  • Search metadata and exact verified loads needed to identify a maintained record or answer a stated work question.
  • Current evidence. An explicit user statement that a lasting decision is current, corrected, or superseded is accepted authoritative evidence for that decision. Investigate only genuinely missing material evidence; do not seek independent corroboration or reconfirmation for that statement, reconstruct a conversation, or manufacture a durable fact.

Outputs + DONE

  • Skill(spectre-capture) or Skill(spectre-work-record) returns a saved, updated, or no-op result. Report its record kind, exact ID, and outcome.
  • A broad account always uses the seven-section work record form. No Learn output creates a knowledge skill, separate dossier, or SessionStart entry.
  • DONE when qualifying evidence has reached Capture or bare Learn truthfully reports a no-op.
Show full SKILL.md (211 more words)Show less

Method / guardrails

  1. Identify intent from the request. A bare request scans the conversation for accepted consequential decisions, verified reusable constraints, corrections, or confirmed blockers/resolutions. An explicit user correction is already-authorized evidence, not an unsupported hypothesis; routine progress and model-generated hypotheses are no-ops.
  2. For an insight or correction, provide Skill(spectre-capture) the evidence, authority, and maintained-knowledge target. For an explicit user correction, cite that direction as evidence, revise the current record, and retain disagreeing repository statements only as stale or historical context; absence of repository corroboration is not missing evidence. For work summary, explicit snapshot, or historical correction, provide Skill(spectre-work-record) the exact run/PR/candidate association and only truthful lifecycle facts.
  3. The knowledge skill reads ${CLAUDE_PLUGIN_ROOT}/skills/spectre-capture/references/knowledge-capture-input.json; the work-record skill reads spectre-work-record/references/work-capture-input.json. Each owns construction, revisions, tags, saving, and recovery. Learn does not duplicate that SOP or write records. Already-authorized facts need no new proposal or approval loop.

Handoff

HandoffDetails
🧭 Current phaseDone
📦 What was just doneResult
▶️ Proposed next stepRender resolved action.

Return the compact Capture result: knowledge|work, ID, and saved|updated|no-op. Surface conflicts with explicit user decisions and missing evidence.

Escalate-If

The request is ambiguous, would persist a model-generated or unaccepted third-party claim, cannot identify an ambiguous work association, or contains conflicting explicit authoritative directions without a clear latest decision.

© 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 2 other files (scripts) in plugins/spectre/skills/spectre-learn of joenandez/spectre.

  • SKILL.md
  • scripts/migrate-knowledge.mjs
  • scripts/register-knowledge.mjs

Open the folder on GitHubat commit 931c9e8

Compare with similar skills

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

Spectre Learn compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spectre Learn this skilljoenandez/spectre164—~1kAutomated safety check: PassMIT
Learning to Learn (OpenMAIC)THU-MAIC/OpenMAIC40k—~502Automated safety check: PassMIT
Scikit LearnK-Dense-AI/scientific-agent-skills48k1 repos~3.3kAutomated safety check: NotesBSD-3-Clause
Project Learnings Managergarrytan/gstack136k—~8.2kAutomated safety check: NotesMIT
Capturealirezarezvani/claude-skills28k1 repos~2.8kAutomated safety check: PassMIT
Learnmakecindy/cindy3k—~368Automated safety check: PassApache-2.0

Similar skills

  • A Chinese-language skill that embeds learning strategies like retrieval practice and self-explanation as a parallel goal inside an OpenMAIC subject lesson, without making study skills the topic.

    40k GitHub stars~502 tokensUpdated today
    EducationAuto-check passed
  • Scikit Learn

    K-Dense-AI/scientific-agent-skills

    Supports machine learning in Python with scikit-learn. An agent skill from K-Dense-AI/scientific-agent-skills.

    48k GitHub starsUsed in 1 repo~3.3k tokens
    Data & AnalyticsAuto-check: notes
  • Lets you review, search, prune and export the learnings gstack has collected across sessions, and surfaces them when a past fix or pattern comes up.

    136k GitHub stars~8.2k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Capture

    alirezarezvani/claude-skills

    Captures and organizes chaotic brain dumps into a structured, actionable system with zero information loss.

    28k GitHub starsUsed in 1 repo~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Learn

    makecindy/cindy

    Distill a reusable Cindy Skill from the current task, a described workflow, or a SkillHub skill through Cindy's review flow when the user directly invokes /learn or /skill:learn in Pi.

    3k GitHub stars~368 tokensUpdated today
    MobileAuto-check passed
  • [DEPRECATED - use continuous-learning-v2] Legacy v1 stop-hook skill extractor.

    276k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

More from joenandez/spectre

All 26 skills in this repo
  • Verify Spectre

    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.

    164 GitHub stars~1.5k tokensUpdated 7 days ago
    Auto-check passed
  • 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 7 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 7 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 7 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 7 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 7 days ago
    Auto-check passed

Questions about Spectre Learn

What does Spectre Learn do?

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

When should I use Spectre Learn?

Spectre Learn fits situations like: the user invokes /learn; asks to remember; summarize consequential project work; interpret the request and delegate persistence to Capture.

How do I install Spectre Learn in Claude Code?

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

How do I install Spectre Learn in Codex?

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

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

What does Spectre Learn need to run?

Going by SKILL.md and its folder, Spectre Learn needs JavaScript for the scripts in its folder. Our summary lists: Node.js.

Does Spectre Learn 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 Spectre Learn 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 Spectre Learn use?

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

About 1k 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 Spectre Learn?

Skills that share tags, products or a category with Spectre Learn: Learning to Learn (OpenMAIC) (THU-MAIC/OpenMAIC, 40k stars), Scikit Learn (K-Dense-AI/scientific-agent-skills, 48k stars), Project Learnings Manager (garrytan/gstack, 136k stars) and Capture (alirezarezvani/claude-skills, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spectre Learn?

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.