template
/template - Skill Template
Copy this folder to create a new skill.
Usage
/your-skill [args]
Step 0: Timestamp
date "+π %H:%M %Z (%A %d %B %Y)"
Step 1: Run Script
bun scripts/main.ts "$ARGUMENTS"
Or fallback (if Bun not available):
npx tsx scripts/main.ts "$ARGUMENTS"
Step 2: Process Output
Display results from script.
Creating a New Skill
- Copy
_template/folder - Rename to your skill name
- Update
SKILL.md:- Change
name:in frontmatter - Change
description:in frontmatter - Update usage instructions
- Change
- Edit
scripts/main.tswith your logic - Test locally with
bun scripts/main.ts
File Structure
your-skill/
βββ SKILL.md β Instructions for Claude
βββ scripts/
βββ main.ts β Bun Shell logic
Frontmatter Required
---
name: your-skill-name
description: One line description. Use when user says "X", "Y", or "Z".
---
Note: Description is the trigger signal. Include action words and use cases.
ARGUMENTS: $ARGUMENTS
More from soul-brews-studio/arra-oracle-skills
recap
Session orientation and awareness β retro summaries, handoffs, git state, focus. Use when starting a session, after /jump, lost your place, switching context, or when user asks "now", "where are we", "what are we doing", "status", "recap". Do NOT trigger for "standup" or "morning check" (use /standup), or session mining "dig", "past sessions" (use /dig).
22learn
Explore a codebase with parallel Haiku agents β clone, read, and document. Modes β --fast (1 agent), default (3), --deep (5). Use when user says "learn [repo]", "explore codebase", "study this repo", or shares a GitHub URL to study. Do NOT trigger for finding projects (use /trace), session mining (use /dig), or cloning for active development (use /incubate).
21project
Clone and track external repos. Use when user shares GitHub URL to study or develop, or says "search repos", "find repo", "where is [project]". Actions - learn (clone for study), search/find (search repos), list (show tracked). For active development, use /incubate.
20rrr
Create session retrospective with AI diary and lessons learned. Use when user says "rrr", "retrospective", "wrap up session", "session summary", or at end of work session.
20forward
Create handoff + enter plan mode for next session. Use when user says "forward", "handoff", "wrap up", or before ending session.
20oracle-soul-sync-update
Sync Oracle instruments with the family. Check and update skills to latest version. Use when user says "soul-sync", "sync", "calibrate", "update", or before /awaken.
19