Updated 4mo ago
by Erikole21
refacil-sdd-ai
SDD-AI (Specification-Driven Development with AI) packaged as a CLI. Installs skills and sub-agents for Claude Code, Cursor, Codex,OpenCode that guide the developer through a structured AI-assisted development workflow, using refacil-sdd/ as the specification store, plus a local bus so agents across different repos can communicate with each other.
25 GitHub stars (25)
Steady at 25 stars — no new stars in the 16 days since Sep 30.
- 23 skills (23 skills found in its SKILL.md files)
- 11 forks (11 forks)
- 4mo ago last update (Last updated 4mo ago)
Install
Skills CLI
npx skills add Erikole21/refacil-sdd-ai
Asks which skills and agents to install. Just one: npx skills add Erikole21/refacil-sdd-ai --skill 'refacil:apply' — add -g for every project.
Claude Code
git clone https://github.com/Erikole21/refacil-sdd-aicp -r "refacil-sdd-ai/skills/apply" ~/.claude/skills/
Copies the refacil:apply skill into ~/.claude/skills/ for every project (use .claude/skills/ for one project). Repeat for the other skills listed below.
Plugin
/plugin marketplace add Erikole21/refacil-sdd-ai
Run inside Claude Code if the repository ships a plugin marketplace, then pick plugins from /plugin.
Skills can run code on your machine — read the SKILL.md first.
What it does
In the author's own words, from each skill's SKILL.md.
-
refacil:apply
Implement the tasks of a proposed change — verifies artifacts and working branch, builds a structured briefing, and delegates to the refacil-implementer sub-agent to execute the implementation in isolated context
skills/apply/SKILL.md on GitHub (opens in a new tab) -
refacil:archive
Archive a completed change — move artifacts to archive and sync specs
skills/archive/SKILL.md on GitHub (opens in a new tab) -
refacil:ask
Ask something directed to another session on the bus. Optionally blocks waiting for the response (--wait N seconds) for automatic LLM-to-LLM flow.
skills/ask/SKILL.md on GitHub (opens in a new tab) -
refacil:attend
Active bus listening mode. Waits for questions directed to this session, processes them and responds; then continues listening. Enables automatic LLM-to-LLM conversation between repos.
skills/attend/SKILL.md on GitHub (opens in a new tab) -
refacil:autopilot
Run the SDD implementation cycle autonomously after /refacil:propose was approved by the human — chains apply → test → verify → review → archive → up-code in a single invocation, and notifies the user via WhatsApp through Kapso when finished (success or failure). Use when the user says "autopilot", "ejecuta el resto del flujo", "termina solo", "modo autónomo", or indicates they will step away fro…
skills/autopilot/SKILL.md on GitHub (opens in a new tab) -
refacil:bug
Guided complete flow to investigate and fix bugs — delegates investigation and fix to the refacil-debugger sub-agent in two passes separated by user confirmation
skills/bug/SKILL.md on GitHub (opens in a new tab) -
refacil:explore
Explore and investigate the codebase before making changes — delegates to the refacil-investigator sub-agent to analyze architecture, flows, and dependencies without modifying anything
skills/explore/SKILL.md on GitHub (opens in a new tab) -
refacil:guide
Interactive guide for the SDD-AI methodology — explains which command to use based on what you need to do
skills/guide/SKILL.md on GitHub (opens in a new tab) -
refacil:inbox
View new messages from the room since the last time you read them. Useful when a question with --wait expired without a response.
skills/inbox/SKILL.md on GitHub (opens in a new tab) -
refacil:join
Join (or create) an agent bus room to communicate with Claude Code, Cursor, OpenCode, or Codex sessions in other repos. Session name = repo folder name.
skills/join/SKILL.md on GitHub (opens in a new tab) -
refacil:prereqs
Internal reference — SDD-AI prerequisites shared by all other refacil skills (do not invoke manually)
skills/prereqs/SKILL.md on GitHub (opens in a new tab) -
refacil:propose
Create a complete change proposal — delegates codebase exploration and artifact generation to the refacil-proposer sub-agent, and handles mandatory human review of the artifacts
skills/propose/SKILL.md on GitHub (opens in a new tab) -
refacil:read-spec
Listen to SDD spec Markdown files in the browser with on-device TTS (Supertonic). Use after propose or on-demand for active changes and archived specs.
skills/read-spec/SKILL.md on GitHub (opens in a new tab) -
refacil:reply
Reply to the last question directed to this session on the bus. The broker autocompletes the correlationId.
skills/reply/SKILL.md on GitHub (opens in a new tab) -
refacil:review
Code review with the team quality checklist — builds a briefing with changed files and project type, delegates to the refacil-auditor sub-agent, and processes the verdict
skills/review/SKILL.md on GitHub (opens in a new tab) -
refacil:say
Send a message to the entire bus room (broadcast). For general announcements, not directed questions.
skills/say/SKILL.md on GitHub (opens in a new tab) -
refacil:setup
Configure the repository for SDD-AI — refacil-sdd layout, AGENTS.md / .agents/, IDE indexes, and methodology hooks
skills/setup/SKILL.md on GitHub (opens in a new tab) -
refacil:stats
Show statistics for a change — token savings, review history, compact and CodeGraph telemetry; optional narrative interpretation
skills/stats/SKILL.md on GitHub (opens in a new tab) -
refacil:status
Show which phase of the SDD-AI cycle a change is in and the exact command to resume it — use for "where am I?", "how is it going?", "status of the change", "resume", "where did I leave off". Distinct from /refacil:stats (which shows telemetry, token savings, and review metrics). Use /refacil:status to navigate the flow; use /refacil:stats for observability data.
skills/status/SKILL.md on GitHub (opens in a new tab) -
refacil:test
Generate unit tests based on SDD artifacts or for specific files — builds a briefing with CA/CR and file scope, and delegates to the refacil-tester sub-agent for generation and execution in isolated context
skills/test/SKILL.md on GitHub (opens in a new tab) -
refacil:up-code
Push code and create PR for integration — git add, commit, push, and PR to the target branch
skills/up-code/SKILL.md on GitHub (opens in a new tab) -
refacil:update
Detect and apply pending migrations of the SDD-AI methodology to the current project
skills/update/SKILL.md on GitHub (opens in a new tab) -
refacil:verify
Validate that the implementation meets the specs — builds a briefing with testCommand and CA/CR criteria, delegates to the refacil-validator sub-agent for the report, and handles corrections with user approval
skills/verify/SKILL.md on GitHub (opens in a new tab)
No skill matches that filter.
Review before you install
A skill is a set of instructions and scripts your agent will follow, and it can run code on your machine. Read the SKILL.md and any scripts first — this listing is not a security review.
Similar skills
-
ECCby affaan-m The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Cod…
-
reaby morluto Reverse engineer anything with agents, from app behavior down to native binaries.
-
andrej-karpathy-skillsby multica-ai A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
-
ponytailby DietrichGebert Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
-
ui-ux-pro-max-skillby nextlevelbuilder An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
-
graphifyby Graphify-Labs Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Curs…