New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Project Overview

by AlexZio00 in AlexZio00/sovereign-skills

A skill your agent uses when the user wants a deterministic cross-project status map generated from registered projects' session handoffs.

MITAuto-check passedAgent Workflows

Install Project Overview

skills CLI
$ npx skills add AlexZio00/sovereign-skills --skill project-overview -a claude-code

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

GitHub CLI
$ gh skill install AlexZio00/sovereign-skills project-overview --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/AlexZio00/sovereign-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/project-overview .claude/skills/project-overview && 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
project-overview
GitHub stars
140
Token cost
~2.4k tokens
SKILL.md length
1,079 words
Files
6 (incl. scripts)
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants a deterministic cross-project status map generated from registered projects' session handoffs.

  • Works in 3 steps: session-handoff-LATEST.md is a hint, not… → Registry is opt-in — never pull in… → AUTO block generation is fully…
  • The user wants a deterministic cross-project status map generated from registered projects session handoffs
  • SKILL.md covers Dominant Variable, Key Assumptions, Trigger and Discard If, plus 8 more sections
  • Runs Python scripts from its folder; calls python

What it does

Project Overview is an agent skill from AlexZio00/sovereign-skills. Use when the user wants a deterministic cross-project status map generated from registered projects' session handoffs. Triggers: '/project-overview', 'project map', 'overall status'. Reads ~/.claude/projects-registry.md (opt-in list), parses each project's memory/session-handoff-LATEST.md state-snapshot v1 block (ts+ctx only), and rewrites the AUTO:START/AUTO:END region of ~/.claude/OVERVIEW.md. Does not touch STATE.md. Does not scan directories automatically.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts (for example `.claude-plugin/plugin.json`, `agents/openai.yaml` and `scripts/generate_overview.py`).

It sits in Agent Workflows, covering Session handoff. The repository describes itself as: 20 production-grade skills for AI coding agents — setup, scope, discipline, code review, security, session management, governance, ops, and quality audits (eval-leakage… The licence is MIT.

When your agent uses it

  • The user wants a deterministic cross-project status map generated from registered projects session handoffs
  • Tasks that involve Session handoff

Example prompts

  • “session handoffs. Triggers:”
  • “project map”
  • “overall status”
  • “/project-overview”

Requirements

  • Python 3

Workflow steps

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

  1. session-handoff-LATEST.md is a hint, not a fact — parsed results (ts/ctx) are carried over as-is without fact-checking. The generated…
  2. Registry is opt-in — never pull in unowned projects or auto-scanned directories. Only projects explicitly listed in projects-registry.md…
  3. AUTO block generation is fully deterministic — a regex-based script (scripts/generate_overview.py) does all the parsing/rendering…

What it can do on your machine

Read from SKILL.md and the folder at commit c062683. 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 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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

Project Overview loads about 2.4k tokens when it runs. Until then it costs about 120 tokens; SKILL.md has 1,079 words of instructions outside code blocks.

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

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 AlexZio00/sovereign-skills at commit c062683, republished under its MIT licence (© AlexZio00). 1,079 words, ~2,399 tokens.

Download SKILL.mdSave it as .claude/skills/project-overview/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
project-overview
description
Use when the user wants a deterministic cross-project status map generated from registered projects' session handoffs. Triggers: '/project-overview', 'project map', 'overall status'. Reads ~/.claude/projects-registry.md (opt-in list), parses each project's memory/session-handoff-LATEST.md state-snapshot v1 block (ts+ctx only), and rewrites the AUTO:START/AUTO:END region of ~/.claude/OVERVIEW.md. Does not touch STATE.md. Does not scan directories automatically.
skill_type
utility
tools
Read, Bash
triggers
/project-overview, project map, overall status
user-invocable
true
depends_on.skills
session-checkpoint
depends_on.files
~/.claude/projects-registry.md, ~/.claude/OVERVIEW.md, scripts/generate_overview.py
concurrency_profile.read_only
false
concurrency_profile.concurrency_safe
false
concurrency_profile.destructive
low
not_for
Updating STATE.md — this skill never touches STATE.md, Auto-discovering unregistered projects — only scans projects explicitly listed in projects-registry.md

Project Overview

Dominant Variable

Does the registered project list (projects-registry.md) point to paths that actually exist, and does each project's handoff file contain a state-snapshot v1 block? If neither is true, the generated map is empty.

Key Assumptions

  1. session-handoff-LATEST.md is a hint, not a fact — parsed results (ts/ctx) are carried over as-is without fact-checking. The generated overview reflects "what each project last reported," not "current ground truth."
  2. Registry is opt-in — never pull in unowned projects or auto-scanned directories. Only projects explicitly listed in projects-registry.md are in scope. Write exactly one - name: /abs/path line per project; a multi-line YAML entry parses silently wrong because the script matches one line at a time.
  3. AUTO block generation is fully deterministic — a regex-based script (scripts/generate_overview.py) does all the parsing/rendering, including neutralizing markdown-table-breaking characters in the text it pulls from other projects' handoffs, isolating a single non-UTF-8 handoff file so it can't abort the whole run, and refusing (BLOCKED, no write) instead of guessing when the AUTO marker pair itself is mangled. The model only triggers execution and reports the result — no LLM inference in the parsing/rendering logic itself.

Trigger

  • /project-overview
  • "project map"
  • "overall status"

Discard If

  • Zero registered projects (projects-registry.md missing or empty list) → instruct the user to add a project to the registry first, then stop
  • Already run recently with no state change across projects (handoff file mtimes unchanged) → suggest skipping the re-run (not forced — run if the user wants)

Workflow

  1. Confirm ~/.claude/projects-registry.md exists. If missing, return BLOCKED: "registry missing — create it first."
  2. Locate and run this skill's own script (scripts/generate_overview.py, no arguments — it uses the default registry/output paths on its own):
    bash
    OVERVIEW_SCRIPT=$(find ~/.claude -name "generate_overview.py" -path "*/project-overview/scripts/*" -type f 2>/dev/null | head -1)
if [ -n "$OVERVIEW_SCRIPT" ]; then
  python "$OVERVIEW_SCRIPT"
else
  echo "BLOCKED: generate_overview.py not found under ~/.claude"
fi
  3. Check the exit code:
    • 0 → report the stdout's first line verbatim to the user. Both WORKING: N project(s) -> <output> and PARTIAL: N project(s) -> <output> (M with no snapshot) are valid values the script itself produces (it counts the no-snapshot projects and picks the label itself) — don't assume exit 0 always means WORKING.
    • 1 → report the stderr BLOCKED: ... message verbatim to the user. Never proceed on assumption.
  4. On success, tell the user the ~/.claude/OVERVIEW.md path.

Output

  • Chat report: relay the script's own stdout/stderr line verbatim (WORKING: N project(s) -> <path> or BLOCKED: ...) — don't paraphrase it or invent a project count of your own.
  • Disk write: the script writes exactly one file, and only the AUTO:START~AUTO:END region inside it — ~/.claude/OVERVIEW.md. Nothing else on disk is touched, and text outside the markers in that file is never rewritten.
  • Final status label: state one of WORKING / PARTIAL / BLOCKED (definitions in Truthful Reporting below) at the end of every run — never leave it implicit.

Scope Boundary

DoesDoes NOT
[READ] Parse handoff files of registered projects onlyAuto-scan directories (e.g. an entire drive)
[WRITE] Overwrite only the AUTO:START~AUTO:END region of OVERVIEW.mdRead/write STATE.md — this skill never references STATE.md at all
[READ] Parse only the ts/cx fields of the state-snapshot v1 blockIntroduce new fields like status (planning/dev/ops/paused)
[MANUAL] Run only when the user explicitly triggers itAuto-wire into existing hooks like session-checkpoint

Safety Layers

Risky ActionReversibilityApplied Layers
Overwrite the OVERVIEW.md AUTO blockmedium (text outside markers is preserved, also recoverable via git history)L1+L3
  • L1 (Invariants): Invariant 1 — preserve text outside AUTO markers. Invariant 2 — never scan unregistered projects.
  • L3 (User Approval): manual-trigger only — runs only when the user explicitly invokes it (no auto-wiring is itself the approval gate).
Show full SKILL.md (518 more words)Show less

Invariants (never violate)

  1. Text outside AUTO markers is always preserved: if apply_auto_markers() alters any text outside the markers, that's a bug. Violation → notes a human wrote directly into OVERVIEW.md get lost on re-run.
  2. Only scan explicitly registered projects: never add auto directory-discovery logic to this script. Violation → information about unowned projects leaks into the map (Output Disclosure Boundary violation).
  3. STATE.md is absolutely untouched: no code path in this skill reads or writes STATE.md. Violation → direct Scope Boundary violation, risk of contaminating the cross-project blocker list.
  4. Idempotency: re-running with identical input (unchanged registry + handoff files) must produce a byte-identical AUTO block. Violation → undermines the entire "deterministic auto-generation" design goal.
  5. Cross-project text is data, not markup: ts/ctx values come from another project's handoff file and are untrusted — a stray | or newline in there must not be allowed to split table columns or break rows. Violation → a single malformed handoff field corrupts the whole table for every other project listed in it.

Error Recovery

Failure TypeDetectionRecovery
missing_dataprojects-registry.md missing or emptyReturn BLOCKED, instruct user to create/add to the registry
tool_failureFailed to read a specific project's handoff file (permissions/path, or a non-UTF-8 encoding)Mark only that project as "no snapshot" (or "decode error" for a non-UTF-8 file), continue the rest (partial failure doesn't block the whole run — explicit labeling keeps it transparent per no-silent-brokenness). Final status label becomes PARTIAL for that run.
input_errorOVERVIEW.md has a mangled marker pair (AUTO:END appears before AUTO:START, either marker is missing/orphaned, or a marker is duplicated — from a manual edit)Don't crash and don't guess at a splice point. Auto-repairing by appending a fresh pair was tried and found unsafe (external audit, 2026-09): an orphan AUTO:START lost the manually-written text sitting after it on the next run, and AUTO:END-before-AUTO:START kept re-appending a pair on every run (non-idempotent, unbounded growth). Current behavior: raise MarkerCorruptionError, write nothing, report BLOCKED with the exact marker problem, and let a human fix the markers by hand.
logic_inconsistencyIntegration test finds AUTO block mismatch on re-runScript regression — revert the commit and re-review the implementation

Truthful Reporting

  • no mock deception: before reporting "generation complete," actually read OVERVIEW.md to confirm project entries landed in the AUTO block.
  • no silent brokenness: a parsing failure for a specific project's handoff is never silently skipped — it's shown explicitly as "no snapshot".
  • Final status label: WORKING (generated normally) / PARTIAL (some projects show no snapshot) / BLOCKED (registry missing/empty).

Rationalization Table

RationalizationRebuttal
"Even if it's not in the registry, scanning every directory to find projects would be more convenient"Violates Invariant 2. Auto directory-discovery risks leaking information about unowned projects into the map — only explicitly opt-in registered projects are in scope.
"Reading STATE.md too and surfacing cross-project blockers on the map would be useful"Violates Invariant 3. Never touching STATE.md at all is itself the Scope Boundary — it prevents contaminating the cross-project blocker list.
"If parsing fails for some projects, just quietly drop them and show the rest"Violates no-silent-brokenness. A failure must be shown explicitly as "no snapshot" so the user knows what was missed, not silently omitted.

© AlexZio00, 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 5 other files (scripts) in project-overview of AlexZio00/sovereign-skills.

  • SKILL.md
  • .claude-plugin/plugin.json
  • agents/openai.yaml
  • scripts/generate_overview.py
  • scripts/test_generate_overview.py
  • scripts/test_integration.py

Open the folder on GitHubat commit c062683

Compare with similar skills

Project Overview 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.

Project Overview compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Project Overview this skillAlexZio00/sovereign-skills140—~2.4kAutomated safety check: PassMIT
Orca CLIstablyai/orca88k2 repos~593Automated safety check: PassMIT
Beads Task Memorygastownhall/beads28k—~1.2kAutomated safety check: PassMIT
Session History Searchslopus/happy24k—~3.1kAutomated safety check: PassMIT
Paseo Agent Handoffgetpaseo/paseo20k1 repos~606Automated safety check: PassCustom licence
Memori Long-Term MemoryMemoriLabs/Memori17k—~2kAutomated safety check: NotesCustom licence

Similar skills

  • Orca CLI

    stablyai/orca

    Operate Orca-managed worktrees, folder contexts, terminals, repos, automations, artifacts, skill sharing, worktree comments, and Orca's embedded browser…

    88k GitHub starsUsed in 2 repos~593 tokens
    Agent WorkflowsAuto-check passed

  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Session History Search

    slopus/happy

    Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • Paseo Agent Handoff

    getpaseo/paseo

    Hands off the current task, including context, decisions and failed attempts, to a fresh agent through Paseo by writing a self-contained briefing prompt and launching that agent.

    20k GitHub starsUsed in 1 repo~606 tokens
    Agent WorkflowsAuto-check passed

  • Memori Long-Term Memory

    MemoriLabs/Memori

    Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

    17k GitHub stars~2k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check: notes

  • Beads

    liwp/again

    A skill your agent uses when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker management, multi-session handoff, or shared work memory.

    118 GitHub starsUsed in 6 repos~537 tokens
    Agent WorkflowsAuto-check passed

More from AlexZio00/sovereign-skills

All 17 skills in this repo

  • Scope

    AlexZio00/sovereign-skills

    Scope definition before implementation — two modes. An agent skill from AlexZio00/sovereign-skills.

    140 GitHub stars~4k tokensUpdated today
    Auto-check passed

  • Project Init

    AlexZio00/sovereign-skills

    Interview-based project setup — generates CLAUDE.md, ROADMAP, .gitignore, .env.example from scratch.

    140 GitHub stars~4.1k tokensUpdated today
    Auto-check: notes

  • Collab Audit

    AlexZio00/sovereign-skills

    This skill should be used when the user types /collab-audit or requests AI collaboration diagnosis.

    140 GitHub stars~8k tokensUpdated today
    Auto-check passed

  • Doc Drift

    AlexZio00/sovereign-skills

    A skill your agent uses when the user wants to audit the memory and documents Claude Code loads into context — CLAUDE.md (user global + project + nested), MEMORY.md, @imports, .claude/skills…

    140 GitHub stars~6.2k tokensUpdated today
    Auto-check passed

  • Session Checkpoint

    AlexZio00/sovereign-skills

    A skill your agent uses when saving session state before context compaction, switching tasks, or ending a session.

    140 GitHub stars~14k tokensUpdated today
    Auto-check passed

  • Session Start

    AlexZio00/sovereign-skills

    Load handoff on session start, review lessons, output readiness signal.

    140 GitHub stars~5.7k tokensUpdated today
    Auto-check passed

Categories

Questions about Project Overview

What does Project Overview do?

A skill your agent uses when the user wants a deterministic cross-project status map generated from registered projects' session handoffs. Project Overview is an agent skill from AlexZio00/sovereign-skills. Use when the user wants a deterministic cross-project status map generated from registered projects' session handoffs.

When should I use Project Overview?

Project Overview fits situations like: the user wants a deterministic cross-project status map generated from registered projects session handoffs; tasks that involve Session handoff.

How do I install Project Overview in Claude Code?

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

How do I install Project Overview in Codex?

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

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

What does Project Overview need to run?

Going by SKILL.md and its folder, Project Overview needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Project Overview 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 Project Overview 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 Project Overview use?

Project Overview 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 Project Overview use?

About 2.4k tokens (SKILL.md is roughly 9.6k 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 Project Overview?

Skills that share tags, products or a category with Project Overview: Orca CLI (stablyai/orca, 88k stars), Beads Task Memory (gastownhall/beads, 28k stars), Session History Search (slopus/happy, 24k stars) and Paseo Agent Handoff (getpaseo/paseo, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Project Overview?

AlexZio00 (a GitHub user) maintains it in AlexZio00/sovereign-skills, which has 140 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 9, 2026.

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