The ORKA Skill System

Modular intelligence modules that define your project.

A "Skill" in ORKA is more than a script. It's a package of instructions, templates, and constraints that tells the AI exactly how to build a specific part of your application.

Core System Skills

🚀
system/init

orka-init

The bootstrapper. Sets up the .agent and .orka directories and creates the initial graph.

🧠
system/core

planner

Analyzes the user request and ORKA brain to create a detailed execution plan.

system/core

executor

Takes the plan and executes tool calls to write code, run commands, and verify output.

Domain Skills (Examples)

⚛️
web/framework

nextjs-app

Scaffolds a Next.js App Router application with Tailwind and TypeScript.

🔌
backend/api

fastapi-service

Creates a Python FastAPI service with Pydantic models and automatic docs.

🗄️
database

postgres-connector

Sets up PostgreSQL connection pooling, migrations, and ORM.

Anatomy of a Skill

Every skill lives in its own folder within .agent/skills/. This makes them portable and easy to share.

SKILL.md

The "System Prompt" for the skill. Tells the AI what the skill does and how to behave.

SKILL.meta.json

Metadata: Name, version, dependencies, and parameters.

templates/

Boilerplate code files that the AI can copy/paste or fill in.

# .agent/skills/react-component/SKILL.md

Name: React Component Generator
Description: Creates a new component.

# Instructions
1. Ask user for component name.
2. Check if 'components/' dir exists.
3. Use the 'component.tsx.hbs' template.
4. Ensure all props are typed.
5. Export as default.