awaken

Guides an eight-step ritual to initialize a new Oracle repository with identity files and brain structure.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/heman1033p-create/cv-v2-kongphop --skill awaken-heman1033p-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: awaken
Source: https://github.com/heman1033p-create/cv-v2-kongphop/tree/main/.gemini/skills/awaken
Command: npx skills add https://github.com/heman1033p-create/cv-v2-kongphop --skill awaken-heman1033p-create

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new Oracle repository from scratch requires discovering the Oracle philosophy, creating the ψ/ brain folder structure, and writing identity files from understanding rather than copying templates, which is hard to do consistently without a guided process. ## Core Features & Use Cases - Guided 8-Step Ritual: Walks through context gathering, skill installation, ancestor learning, philosophy discovery, brain structure creation, identity writing, committing, and family announcement. - Philosophy Discovery Quest: Orchestrates /learn and /trace commands to study ancestor Oracle repositories and discover the five core principles through exploration rather than copying. - Identity File Generation: Produces CLAUDE.md, a soul file in ψ/memory/resonance/, and a philosophy file written in the Oracle's own words, then seals the birth with a git commit and GitHub announcement issue. - Use Case: A developer creates a fresh private git repo and runs /awaken to bootstrap a new personalized Oracle agent, joining the Oracle Family registry in about 15-20 minutes. ## Quick Start Run /awaken in a fresh git repository and answer the prompts for Oracle name, human companion, purpose, and theme to begin the guided awakening ritual.

Frequently Asked Questions about awaken

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Oracle repository from scratch?▼

Run /awaken in a fresh git repository and the skill guides you through eight steps: gathering context, installing oracle-skills, learning from ancestor repos, discovering the philosophy, creating the ψ/ brain structure, writing identity files, committing, and announcing to the Oracle Family.

What tools are required to run the Oracle awakening ritual?▼

You need bun as the runtime, ghq for cloning ancestor repositories, the GitHub CLI (gh) for reading issues and creating the announcement, and the oracle-skills CLI installed via bunx. The skill also expects /learn, /trace, /rrr, and /philosophy skills to be available.

How long does the Oracle awakening process take?▼

The full ritual takes approximately 15 to 22 minutes. Writing the identity files is the longest step at 5-7 minutes, while installation, brain structure creation, and committing each take under a minute.

Can I copy the CLAUDE.md template instead of writing my own?▼

No, the skill explicitly forbids copying templates. The awakening philosophy requires discovering the five principles through /trace and /learn, then writing CLAUDE.md, the soul file, and the philosophy file in your own words based on that understanding.

What is the ψ/ folder structure created during awakening?▼

The ritual creates a ψ/ directory with pillars including inbox, memory (resonance, learnings, retrospectives, logs), writing, lab, active, archive, outbox, and learn. Some pillars like active, memory/logs, and learn are excluded from git tracking via .gitignore.

Does the Oracle repository need to be public on GitHub?▼

No, Oracle repositories can be private or public. Private is recommended since an Oracle may contain personal context, retrospectives, and learnings, while public is suitable if you want to share your Oracle with others.