Help
Contextual guidance and command discovery.
Install
npx skills add agenticnotetaking/arscontexta --skill help -g -a claude-code -y- Repository
- agenticnotetaking/arscontexta3.5k
- Category
- Engineering
- Updated
- 8mo ago
- License
- MIT
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Contextual guidance and command discovery. Three modes, narrative (first-time), contextual (mid-task), compact (quick reference). Shows available commands, active skills, and intelligent suggestions based on vault state. Triggers on "/help", "what can I do", "show commands", "how does this work".
EXECUTE NOW
Target: $ARGUMENTS
Parse immediately:
- If target contains
--compact: force compact mode regardless of vault state - If target contains a skill name (e.g., "help reduce" or "help reflect"): show detailed help for that specific skill
- If target is empty: determine mode from vault state
Execute these steps:
- Gather vault state (Step 1)
- Resolve domain vocabulary (Step 2)
- Determine mode (Step 3)
- Discover commands dynamically (Step 4)
- Render the appropriate mode (Step 5)
START NOW. Reference below defines each step.
Step 1: Gather Vault State
Determine the notes folder by checking which domain-named directory exists (notes/, reflections/, concepts/, ideas/, decisions/, memories/, or any custom name from derivation-manifest.md). Then gather counts:
- Note count:
.mdfiles in the notes folder, excluding MOCs (files withtype: mocin frontmatter) - Inbox count:
.mdfiles in the inbox folder (inbox/, journal/, encounters/, etc.) - Observation count:
.mdfiles inops/observations/orops/methodology/ - Tension count:
.mdfiles inops/tensions/ - Connection density: count wiki links (
[[) across notes folder; sparse if fewer than 2x note count - Queue state: pending tasks in
ops/queue/queue.yamlorops/queue/queue.json - Health warnings: check latest report in
ops/health/if it exists - Tutorial state: check
ops/tutorial-state.yamlfor incomplete tutorial - Session count: estimate from
ops/sessions/file count (indicates usage maturity)
# Quick state gathering
note_count=$(ls -1 {vocabulary.notes}/*.md 2>/dev/null | wc -l | tr -d ' ')
inbox_count=$(ls -1 {vocabulary.inbox}/*.md 2>/dev/null | wc -l | tr -d ' ')
obs_count=$(ls -1 ops/observations/*.md ops/methodology/*.md 2>/dev/null | wc -l | tr -d ' ')
tension_count=$(ls -1 ops/tensions/*.md 2>/dev/null | wc -l | tr -d ' ')
