Skill

list-contexts

List all CONTEXT files across code/, projects/, repos/, and vaults/ with status and metadata. Use when viewing context registry, checking saved sessions, or syncing INDEX.md. Triggers include "list contexts", "show contexts", "context registry", "sync index".

Install

npx claudepluginhub digital-stoic-org/agent-skills --plugin dstoic

Tool Access

This skill is limited to using the following tools:

BashReadEditWriteGlobAskUserQuestion

Preview

Scan `CONTEXT-*-llm.md` files across `{repo-root}/code/`, `projects/`, `repos/`, and `vaults/` — display cross-project context registry.

Supporting Assets

reference.md

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

169.2k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

169.2k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

169.2k

Stats

Parent Repo Stars5

Parent Repo Forks2

Last CommitFeb 26, 2026

Actions

View Source View Plugin View on GitHub View README

List Contexts

Scan CONTEXT-*-llm.md files across {repo-root}/code/, projects/, repos/, and vaults/ — display cross-project context registry.

Speed: < 3 seconds

Performance Rules

Use rtk for ALL shell commands (exception: git rev-parse in Phase 1)
Parallel tool calls — ALL independent calls in one message
No unnecessary reads — extract metadata from header only (first 15 lines)

Workflow

Phase 1: Resolve Root & Scan (parallel)

Bash: git rev-parse --show-toplevel && git ls-files --others --ignored --exclude-standard --directory -- code/ projects/ repos/ vaults/ | head -50
Glob: **/code/**/CONTEXT-*-llm.md
Glob: **/projects/**/CONTEXT-*-llm.md
Glob: **/repos/**/CONTEXT-*-llm.md
Glob: **/vaults/**/CONTEXT-*-llm.md
Glob: **/code/**/done/CONTEXT-*-llm.md
Glob: **/projects/**/done/CONTEXT-*-llm.md
Glob: **/repos/**/done/CONTEXT-*-llm.md
Glob: **/vaults/**/done/CONTEXT-*-llm.md

Filter out gitignored project folders silently. Files in done/ subfolders are tagged as archived in display.

Phase 2: Read Frontmatter (parallel)

Read first 15 lines per file. Extract: saved, stream, status, focus, goal. Derive from path: Area, Project, Context name.

Phase 3: Format & Display

Parse $ARGUMENTS for filters (--status, --area), actions (--sync, --archive). Group by area, sort by saved timestamp (most recent first). Output emoji-rich markdown table.

Active vs Archived split: Files in project root → Active table. Files in done/ → separate ### 📦 Done section per area (collapsed, shown after active).

Staleness: Active contexts with saved >30 days ago → append ⚠️ stale to status.

CHECKPOINT: If --sync or --archive was passed, you MUST proceed to Phase 4-5. Do NOT stop here.

Phase 4-5: Sync/Archive

MANDATORY when --sync or --archive is passed. Do NOT skip.

--sync → Read INDEX.md (or create if missing via Write). Regenerate Active Contexts table from Phase 2 data. Preserve other sections. Update summary counts. Confirm to user what changed.
--archive <stream> → move to Archived section with user reason

--sync and --archive are mutually exclusive.

See reference.md for output template, status mapping, sync/archive format, and error messages.