agentleFS
afaraha8403afaraha8403/balakit/.agents/skills/execute/SKILL.md

execute

Skill1 starsChanged 8 days agoMITView on GitHub

Asks workers on the current harness to research read-only, then this chat does the work. Default roster is the current model on every slot. Apply when the user invokes execute or /execute, or wants workers to research before this chat writes. Use opinion when nobody should write. Use inception to produce the plan first. Use kit-workflows for one-agent implementation. Use deep-deliberation for checkpointed decisions.

57 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use context-optimize, ralplan and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • ibahgatSkill

    context-optimize

    Improve context efficiency and cache stability for long or complex sessions.

    Also in 3 projects that use this

  • ibahgatSkill

    ralplan

    Create a strict, quality-first execution plan with explicit gates and rollback-ready sequencing.

    Also in 5 projects that use this

  • Yeachan-HeoSkill

    ultragoal

    Create and execute durable repo-native multi-goal plans over Codex goal mode artifacts.

    Also in 4 projects that use this

  • buddyhSkill

    deep-dive

    Deep dive on any topic. Decomposes into subtopics, researches each in parallel with thorough source gathering, then synthesizes into a comprehensive report (4,000-10,000+ words, 40-100+ sources). Scales depth dynamically based on topic complexity. Use when asked for a deep dive, deep research, comprehensive analysis, or thorough investigation of a topic.

    Also in 4 projects that use this

  • mukcoSkill

    principles

    General software engineering principles — DRY, SOLID, YAGNI, KISS, naming, code smells, and refactoring. Language-agnostic. Use alongside language-specific skills.

    Also in 3 projects that use this

  • team-attentionSkill

    compound

    This skill should be used when the user says "/compound", "compound this", "document learnings", "save what we learned", or after completing a PR. Extracts knowledge from PR context and saves to docs/learnings/.

    Also in 3 projects that use this

  • +1 more from ibahgat

The file

We split this skill into the rules it gives an agent

12 rules. 0 are common, 8 are distinctive, and 4 are very specific to this project.

  • 0

    Common

    Most of the 55 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 4

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Do not auto-start this skill.

    line 38
  2. Distinctive:

    Do not invent a model name.

    line 41
  3. Very specific:

    Never write a spawn identifier in a question, option, chat roster, worker prompt, or take label.

    line 42
  4. Very specific:

    If this host cannot spawn a child at all, stop.

    line 45
  5. Distinctive:

    If the user already named 2–5 models that exist on this host, use them.

    line 71
  6. Very specific:

    If the user said auto-pick (or chose it), run auto-pick for agents families from references/hosts.md, announce with display names, then …

    line 75
  7. Distinctive:

    Do not spawn yet.

    line 95
  8. Very specific:

    If they assign each worker, ask one question per slot (not a multi-select).

    line 97
  9. Distinctive:

    No structured question tool → numbered text fallback.

    line 103
  10. Distinctive:

    Keep valuable minority observations.

    line 108
  11. Distinctive:

    Do the work here. Do not delegate writes back to workers.

    line 109
  12. Distinctive:

    Never invent a missing take.

    line 124

“Common” is measured: kept by at least 6 in 10 of the 55 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Execute

Leading words: current first, same-family ok, slug shield, auto-pick stays distinct, this chat does the work.

Workers research. This chat does the work. There is no agent-count flag — pick 2 or 3 from the job (default 3; 2 if the request is small, local, or mechanical).

Operating contract

  • Do not auto-start this skill. The user must ask for it.
  • Current-for-all is the default. Same family may occupy more than one slot when they chose that.
  • Auto-pick is the only path that still requires distinct families.
  • Do not invent a model name. Use the live list this harness exposes.
  • Never write a spawn identifier in a question, option, chat roster, worker prompt, or take label. Map family → live-list name only in the spawn tool's model argument. Current → inherit (or omit model).
  • Workers are read-only. A worker that edits files has failed; discard that take.
  • This chat writes after the takes. Do not send writes back to workers.
  • If this host cannot spawn a child at all, stop. Auto-pick that cannot gather two families: offer Current-for-all or deep-deliberation.

Runtime state

EXECUTE_STATE
host: cursor | claude-code | opencode | copilot | codex | other
agents: 2 | 3
roster: unset | Current,OpenAI,…
takes: 0/N
next_action: one action only

Pipeline

Copy these steps into the todo list verbatim. Skip with skip: <reason>.

  1. Detect the host. Read references/hosts.md. Build the live spawnable model list. Current-for-all does not need two families.
  2. Set agents to 3, or 2 if the request is small, local, or mechanical. If the user named models (or current), use that list (2–5) instead of auto-pick. One named model fills every slot.
  3. Resolve roster: models the user named, or Current for all, or auto-pick, or assign each worker. Announce with display names before spawning.
  4. Spawn one read-only worker per roster slot. Same prompt. Parallel. Read references/worker-prompt.md.
  5. Render labeled takes ([Current], [OpenAI], …). Do not write yet.
  6. This chat merges with [display name] attribution, does the work, proves the real path.

Roster

If the user already named 2–5 models that exist on this host, use them. Same family is allowed. If they named one model, or said current / inherit, fill every slot with that choice.

If the user said auto-pick (or chose it), run auto-pick for agents families from references/hosts.md, announce with display names, then spawn.

Otherwise ask:

prompt: Which models should research?
options:
- Current model for all workers (Recommended)
- Auto-pick distinct families
- I'll assign each worker
- Say this in plain English
allow_multiple: false

Option ids: current, auto, assign, simplify. Never live-list names.

Say this in plain English is a meta question: explain Current vs auto-pick with display-name examples (never spawn ids), then re-ask. Do not spawn yet.

If they assign each worker, ask one question per slot (not a multi-select). Each slot's first option is Current model (Recommended), then one option per remaining family using display names and fam-* ids from references/hosts.md. Same family may be chosen on more than one slot.

No structured question tool → numbered text fallback.

Write

  • Resolve consensus and divergence with [display name] attribution.
  • Keep valuable minority observations. Reject weak claims explicitly.
  • Do the work here. Do not delegate writes back to workers.
  • Prove on the real path (or closest executable check). skip: if the surface cannot be driven.

Reply contract

Playbook: execute
roster: Current, OpenAI, Grok

Then the labeled takes, what shipped, and how you verified.

Delegate failure

  1. Retry one transient spawn failure.
  2. Never invent a missing take.
  3. Fewer than two successful takes → stop, ask whether to retry or abort.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.