Ralph Loop Kiro Specs

What it does

When your agent uses it

• The user mentions ralph loop
• Iterative spec runner
• Run my spec tasks automatically
• Kiro spec automation

Example prompts

• “ralph loop”
• “spec loop”
• “iterative spec runner”
• “/ralph-loop-kiro-specs”

Requirements

• Python 3
• A Bash shell

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Load Context — Read steering files (product.md, structure.md, tech.md) and the target spec (requirements.md, design.md, tasks.md…
2. 2Pick ONE Task — Find the lowest-numbered incomplete top-level task. Record start time. Never pick more than one task per iteration.
3. 3Understand Before Implementing — Read relevant source files, study existing patterns, re-read the Corrections and Codebase Patterns…
4. 4Implement — Implement the task and all subtasks in order. Run typechecks and tests. If something fails: fix it, write a correction…
5. 5Verify Exit Criteria — Re-read exit criteria from requirements.md and design constraints from design.md. Confirm each is satisfied before…
6. 6Update Tracking — Mark the task [X] in tasks.md, append a progress entry to progress.md, add new codebase patterns, do a final correction…

What it can do on your machine

Read from SKILL.md and the folder at commit f1de632. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (Shell), which the agent can run.

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • apache.org

  Also links to:

  • github.com
  • kiro.dev

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ralph Loop Kiro Specs loads about 2.6k tokens when it runs, and up to ~6.6k if it reads all its reference files. Until then it costs about 218 tokens; SKILL.md has 932 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~218

When it runs · the whole SKILL.md, loaded when a task matches

~2.6k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~6.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from fabricioctelles/skills at commit f1de632, republished under its Apache-2.0 licence (© fabricioctelles). 932 words, ~2,605 tokens.

name

ralph-loop-kiro-specs

description

Automated iterative agent runner for spec-based development in Kiro. Wraps kiro-cli in a self-correcting bash loop that picks up tasks from a Kiro spec, implements them one at a time, verifies against exit criteria, and accumulates corrections and codebase patterns across iterations. Use this skill when the user mentions "ralph loop", "ralph", "spec loop", "iterative spec runner", "run my spec tasks automatically", "kiro spec automation", "self-correcting agent loop", "implement spec tasks in a loop", "run kiro-cli in a loop", "automated task implementation", or wants to drive a Kiro spec to completion through repeated agent iterations. Also use when the user wants to set up, configure, troubleshoot, or understand the Ralph Loop workflow — including progress tracking, corrections, codebase patterns, timing logs, and the summary dashboard.

metadata.author

ft.ia.br

metadata.version

1.0

metadata.date

2026-04-28

metadata.license

Apache-2.0

metadata.original_project

https://github.com/mreferre/ralph-loop-kiro-specs

metadata.original_author

mreferre

metadata.category

code-scaffolding-and-templates

- ❌ `python manage.py migrate` → ✅ `python3 manage.py migrate` (system has no `python` alias)
- ❌ Running tests with `npm test` → ✅ `npm run test:unit` (project uses separate test scripts)
- ❌ UNRESOLVED: [description of issue that couldn't be fixed after 5 attempts]

your-project/
├── ralph-loop-kiro-specs-prompt.md    # The Ralph agent prompt template
├── ralph-loop-kiro-specs-script.sh    # The loop runner script
└── .kiro/
    ├── steering/
    │   ├── product.md                 # What the product is
    │   ├── structure.md               # Project structure conventions
    │   └── tech.md                    # Tech stack and tooling
    └── specs/
        └── <specs_name>/
            ├── requirements.md        # Requirements and exit criteria
            ├── design.md              # Architecture and design decisions
            ├── tasks.md               # Task checklist
            ├── progress.md            # Auto-created: corrections, patterns, progress log
            ├── specs_time.md          # Auto-created: per-task timing
            └── summary.html           # Auto-generated on completion: visual dashboard

./ralph-loop-kiro-specs-script.sh <max_iterations> <specs_name>

# Run up to 15 iterations on the "auth-feature" spec
./ralph-loop-kiro-specs-script.sh 15 auth-feature

Copyright [mreferre]

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

© fabricioctelles, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts, references) in skills/ralph-loop-kiro-specs of fabricioctelles/skills.

• SKILL.md
• references/ralph-loop-kiro-specs-prompt.md
• scripts/ralph-loop-kiro-specs-script.sh

Open the folder on GitHubat commit f1de632