build-iterated-agentic-loop
build a repo-local skill and install a matching iterated coding-agent GitHub Actions workflow, prompt, memory file, and reference templates
Install / Use
npx skills add humanlayer/skills --skill build-iterated-agentic-loopInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of build-iterated-agentic-loop
build-iterated-agentic-loop scores 92/100 on our quality scale, 828th of 2,790 Automation skills we index (top 30%).
Its SKILL.md is 13 KB long, well organised into 16 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
With 4,472 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so build-iterated-agentic-loop is actively maintained.
- Our last check on 2026-10-05 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
build-iterated-agentic-loop compared with similar skills
All 4 of these similar skills score higher than build-iterated-agentic-loop; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| build-iterated-agentic-loop (this skill)by humanlayer | 92 | 4.5k | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install build-iterated-agentic-loop?
- Run
npx skills add humanlayer/skills --skill build-iterated-agentic-loop. The install tabs above show the steps for each supported agent. - Which AI agents does build-iterated-agentic-loop work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is build-iterated-agentic-loop safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is build-iterated-agentic-loop still maintained?
- The repository was last updated about 2 months ago, so build-iterated-agentic-loop is actively maintained.
Skill content
View source on GitHubname: build-iterated-agentic-loop description: build a repo-local skill and install a matching iterated coding-agent GitHub Actions workflow, prompt, memory file, and reference templates
Build Iterated Agentic Loop
Use this skill when the user wants to turn a repeatable agent task into a repo-local skill plus a GitHub Actions workflow that runs a coding agent on a schedule, manually, or both.
The target shape is an iterated agentic loop: a focused skill defines the agent's judgement, a workflow invokes a coding agent with a repo-specific prompt, an agent-memory file carries standing feedback between runs, and each workflow labels its PRs so only one open PR exists per loop. The narrow-react-prop-types skill is the concrete reference pattern.
Outputs
Create or update these files in the target repo:
.claude/skills/<skill-name>/SKILL.mdfor the repo-local agent behavior..github/workflows/agent-<task-name>.ymlfor the recurring coding-agent automation..github/agent-memory/<task-name>.mdfor stable feedback and scope constraints.- Optional references under
.claude/skills/<skill-name>/references/when the skill needs templates, examples, or long supporting material.
Workflow
1. Explore the target repo
Read before asking setup questions:
- Existing
.github/workflows/*.ymland.github/actions/**to understand runner, checkout, dependency install, cache, and PR patterns. - Package manager files such as
package.json,bun.lock,pnpm-lock.yaml,yarn.lock,package-lock.json,pyproject.toml,go.mod, orCargo.toml, or other package management-related files - Existing validation scripts, especially typecheck, lint, test, quality, format, and package-scoped commands.
- Existing
.claude/skillsand.agents/skillsto avoid duplicating conventions.
Completion criterion: you can name the repo's package manager, install command, likely validation commands, and existing workflow conventions.
2. Ask setup questions
Walk the user through these decisions. Recommend defaults from repo evidence instead of presenting a blank form.
- Coding Agent: Claude Code, Codex, OpenCode, or CodeLayer. Explain the required secret and headless command for the recommended choice. Use
references/agent-runner-templates.md. CodeLayer is Humanlayer's ultra-lightweight agent harness. - Cadence: daily, weekly, weekdays, monthly, manual-only, or custom cron. Recommend a cadence based on task risk and review burden - most likely weekdays, daily, or weekly.
- Task: What task should the agent loop accomplish?
- Are there existing skills for doing this? (you can do research before asking the user this)
- Ask the user if you should look at recent PRs, git history, or other particular parts of the codebase for reference.
- Scope: which directories/packages the loop may change and which it may only inspect
- Validation: which commands must pass before the agent commits (You should propose this to the user based on your earlier research and ask them to confirm)
- PR bounding: Ask if scheduled runs should no-op when open PRs from this agent already exist, and if so, how many open PRs to allow before blocking new runs.
- Recommended: Yes, bound to 1 open PR per agent loop. This prevents the agent from creating unbounded work that piles up faster than humans can review. Without bounding, a daily agent could generate 5+ unreviewed PRs in a week, creating review fatigue and merge conflicts.
- The workflow uses a label (e.g.,
agent-<task-slug>) to identify PRs from each agent loop. Scheduled runs checkgh pr list --label <label> --state openand skip if the count meets or exceeds the bound. - Manual
workflow_dispatchruns bypass the bound check, allowing forced runs when needed.
- PR metadata: label name, PR title prefix, and branch prefix.
- Suggest
[MM/DD][Agent: <Agent Name>]: <Concise Description>as a template, e.g.[6/23][Agent: Effect Migrator]: Migrate XYZ module
- Response format: How should the CI agent format its final response (which becomes the PR body)?
- Show the user
references/response-template.mdfor examples (fix/migration, generation, refactor). - Ask what information reviewers need: summary stats, risk levels, verification steps, file lists, etc.
- Create a customized response template that the generated skill will reference in its
references/directory
- Iteration behavior: whether
/iteratecomments should update the existing PR.
- If enabled, install
references/agent-iteration.tsto the repo. Ask the user's preferred location:.github/scripts/,ci-scripts/, orscripts/. - The script has two modes:
footer(adds the PR body marker) andprompt(builds the iteration prompt from PR context). - If disabled, remove the
issue_commenttrigger and iteration-only steps from the workflow.
Completion criterion: every placeholder in the workflow, prompt, and memory template has a chosen value or an explicit default.
3. Define the agent job
Extract the smallest repeatable job the agent should perform. Work through these three questions with the user:
What are we finding? How does the agent identify targets for this run?
- A CLI tool that reports issues (e.g.,
bunx react-doctor,eslint --format json) - A search pattern (e.g., files matching
*.test.tswithout coverage, components using deprecated APIs) - A diff or changelog (e.g., new dependencies since last release, changed files in a PR)
- An old pattern that should be replaced with a new pattern or migrated to a new framework
- A flaky test based on previous CI runs
What are we changing? What transformation does the agent apply to each target?
- Fix: resolve a reported issue in place
- Migrate: update code from one pattern to another
- Generate: create new files based on existing sources
- Refactor: restructure without changing behavior
How do we validate? What proves the change is correct?
- Build/typecheck passes
- Tests pass (or a specific subset)
- The same tool that found the issue now reports it resolved
- Linting or formatting checks pass
Completion criterion: you can state the job in one sentence, e.g., "Find 5 react-doctor violations, fix them, and verify typecheck and quality pass."
4. Write the skill
Write a repo-local skill that captures the agent's judgement for this task. The skill can include repo-specific paths, package names, and conventions since it lives in this repository.
Use these skill-writing rules:
- Put ordered behavior in
SKILL.mdin the skill directory (.claude/skill-slug-hereor.agents/skill-slug-heredepending on repo patterns and user preferences) steps with checkable completion criteria - Move long templates and examples into sibling reference files, then point to them from
SKILL.md. - Keep one source of truth for each rule; do not repeat the same guidance in the skill, prompt, and memory file.
- Include a response template as a reference file (e.g.,
references/response-template.mdunder the skill directory) that defines how the CI agent should format its final output. The skill should instruct the agent to read and follow this template when formatting its final response which will be used as the PR body. - Use the skill template in
references/skill-template.md. An EXAMPLE skill can be found inreferences/example-skill.md - You may refer to https://agentskills.io/specification to understand skill specification.
IMPORTANT: the name field in the SKILL.md frontmatter must match the skill slug - e.g. a skill with name fix-eslint-issues must be in .claude/skills/fix-eslint-issues/SKILL.md or .agents/skills/fix-eslint-issues/SKILL.md
Completion criterion: the skill explains how to do the job clearly enough that the agent can follow it without additional prompting, including how to format the final response.
5. Write the workflow prompt
Put repo-specific targeting in the GitHub Actions prompt, not in the generic skill. Include:
Begin by using the <skill-name> skill.- Scope: directories/packages the agent may change and may inspect.
- Instructions: the reviewable unit of work, what to avoid, and how to validate.
- Validation commands in fenced bash if applicable
- Agent memory interpolation from
.github/agent-memory/<task-name>.md. - Finishing requirements: validate, commit, push, and return a PR-ready summary.
Use references/workflow-template.yml as the base template. Use references/prompt-template.md when drafting the embedded prompt.
Completion criterion: the prompt contains all repo-specific constraints needed for an unattended run.
6. Install the memory file
Create .github/agent-memory/<task-name>.md using references/memory-template.md as a starting point. The memory file carries standing feedback that should affect future runs. Keep it short.
Good memory entries:
- Permanent scope exclusions.
- Known false-positive areas.
- Review feedback that should change future agent selection.
Bad memory entries:
- One-off task instructions.
- Validation output from a single run.
- Rules already stated in the skill.
Completion criterion: deleting the memory file would lose useful future-run context, not just history.
7. Create the workflow
Create .github/workflows/agent-<task-name>.yml from references/workflow-template.yml and replace every placeholder.
Required customizations:
- Workflow name, cron, branch prefix, workflow id, agent label, PR title.
- Runner label and setup steps for the repo.
- Dependency install command.
- Coding-agent install, secret, and headless run command (from
references/agent-runner-templates.md). - Response extraction step: each agent outputs differently (JSON, stream-json, plain text). Use the agent-specific extraction from
references/agent-runner-templates.mdto get the final response into/tmp/pr-body.mdfor the PR body. - Skill name, scope, validation commands, and memory path.
- PR bounding gate: the workflow checks for open PRs with the agent label before running. Configure the bound based on the user's choice from step 2 (default: 1). The gate uses
gh pr list --label "$AGENT_LABEL" --state openand compares the count. If bounding is disabled, remove the gate step entirely. - If
/iterateis enabled: installreferences/agent-iteration.tsto the user's preferred location and update the workflow paths to match. The script handles both PR footer generation and iteration prompt building. This file can be run with the user's preferred typescript toolchain (node with type-stripping, Bun (recommended), Deno, tsx, etc) or can at the user's request be rewritten into another language.
If /iterate is disabled, remove the issue_comment trigger, the iteration-only steps, and skip installing agent-iteration.ts.
Completion criterion: the workflow can run from workflow_dispatch without relying on files that do not exist.
8. Validate and verify
Validate workflow YAML: Before committing, parse the workflow file to catch syntax errors early. Use one of:
# Node.js / bun (js-yaml)
bunx js-yaml .github/workflows/agent-<task-name>.yml > /dev/null && echo "Valid YAML"
# Python
python -c "import yaml; yaml.safe_load(open('.github/workflows/agent-<task-name>.yml'))"
# yq (if installed)
yq eval '.name' .github/workflows/agent-<task-name>.yml
If the parser fails, fix the YAML syntax before proceeding.
Verify references and paths: Check that every path named by the skill, workflow, and memory file exists or is intentionally created by this task.
Completion criterion: the workflow YAML parses without errors and all referenced files exist.
9. Dry-run the workflow
GitHub Actions workflows cannot be manually dispatched via workflow_dispatch until they have run at least once. To bootstrap the workflow:
- Temporarily add a
pushtrigger for the current branch (if not main):on
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
