saki

This is a mirror copy pStack.. but with some saki flavour

LLM-agnostic engineering skill system for high-quality AI-assisted development.

Write less. Ship better.

Install

# Add saki to your project
npx saki init

# Also register as Claude Code slash commands
npx saki init --claude

What is saki?

saki is a set of markdown-based skill files that encode rigorous engineering practices. Each skill is a standalone prompt that any LLM can understand — Claude, GPT, Gemini, Mistral, or any other model.

It is NOT tied to any IDE or platform. It works wherever you can paste text.

Skills

| Skill | Purpose | |---|---| | /saki-mode | Main entry point. Routes your task to the right playbook and enforces all 23 principles. | | /how | Walk through how a subsystem or component works. | | /why | Explain the design rationale behind a decision or piece of code. | | /architect | Design an API, system, or data model from first principles. | | /interrogate | Multi-angle code review — correctness, performance, security, maintainability. | | /unslop | Remove bloat, complexity, and slop from code or writing. | | /automate-me | Analyze your workflow and generate personalized skill files. |

Playbooks

| Playbook | When to use | |---|---| | bug-fix | Diagnosing and fixing a bug | | feature | Building a new feature | | migration | Migrating code, APIs, or data | | performance | Profiling and optimizing | | overnight-run | Large autonomous multi-step tasks |

The 23 Principles

See principles.md for the full list. They are organized into four groups:

• Core (9) — quality, simplicity, and thoughtfulness
• Architecture (6) — structure and boundaries
• Verification (4) — proof and evidence
• Delegation & Meta (4) — working with agents and teams

Usage

With any LLM (universal)

Paste the contents of any skill file into your prompt:

[paste contents of .saki/skills/saki-mode.md]

Task: Fix the race condition in the auth middleware.

With Claude Code

npx saki init --claude

Then use /saki-mode, /interrogate, /unslop, etc. directly as slash commands.

With Cursor / Windsurf / other IDEs

Copy .saki/skills/*.md files into your IDE's rules or custom instructions directory.

Commands

saki init              # Initialize in current project
saki init --claude     # Also install to ~/.claude/skills/
saki add <skill>       # Add a single skill
saki list              # List available skills

Philosophy

saki is built on one belief: AI should make you write less code, not more. Every principle in saki pushes against bloat, slop, and over-engineering. Quality over quantity. Evidence over assertion. Subtraction before addition.