agentleFS
DioNanosDioNanos/nexuscrew/skills/crew/SKILL.md

crew

Skill4 starsChanged 36 days agoApache-2.0View on GitHub

Use when spawning or coordinating bounded AI worker cells through a Crew MCP fabric, including cell discovery, idempotent spawn, status monitoring, structured results, follow-up tasks, cancellation and the inter-cell message bus. Covers safe worktree isolation, durable audit reports and user-language selection.

15 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

14 rules. 0 are common, 7 are distinctive, and 7 are very specific to this project.

  • 0

    Common

    Most of the 15 edited versions we read keep these.

  • 7

    Distinctive

    This author's own choices. Worth a look.

  • 7

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use Crew for bounded delegated work.

    line 8
  2. Distinctive:

    Keep cell names, engine/profile IDs, thread IDs, tool names, paths and quoted worker output unchanged unless the user explicitly asks to …

    line 20
  3. Very specific:

    Use cell_list to inspect the cells and engines visible to the caller.

    line 27
  4. Very specific:

    Verify that the worker's cwd contains the instructions and project context it needs.

    line 29
  5. Distinctive:

    Do not assume an embedded worker inherits the coordinator's MCP servers.

    line 31
  6. Very specific:

    If no Crew tools are exposed and this skill is packaged with NexusCrew, the optional companion is documented in ../../MCP_COMPANIONS.md.

    line 35
  7. Very specific:

    Call cell_spawn with a bounded task, explicit cwd, background mode and a caller-stable idempotency_key.

    line 41
  8. Very specific:

    Keep the returned crewd_thread_id.

    line 43
  9. Very specific:

    Treat idle as normal turn completion.

    line 47
  10. Very specific:

    Read cell_result and inspect exit_status, final_answer and the bounded event tail.

    line 50
  11. Distinctive:

    Verify the worker's files and tests yourself before accepting code changes.

    line 52
  12. Distinctive:

    Do not let two mutating workers edit the same worktree concurrently.

    line 59
  13. Distinctive:

    Use follow-up tasks only when the original thread and scope remain valid.

    line 62
  14. Distinctive:

    Verify that the report is a non-symlink regular file, read it completely and confirm its verdict matches the callback.

    line 74

“Common” is measured: kept by at least 6 in 10 of the 15 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

Crew

Use Crew for bounded delegated work. A coordinator submits tasks to worker cells through an MCP server; spawning is asynchronous and returns a thread ID.

Select response language

Choose the language for user-facing explanations and summaries in this order:

  1. the user's explicit language preference;
  2. the language of the current request;
  3. a reliable client or system locale;
  4. English.

Keep cell names, engine/profile IDs, thread IDs, tool names, paths and quoted worker output unchanged unless the user explicitly asks to translate them. Tell a worker which output language is required when its deliverable is user-facing.

Discover before spawning

  1. Use cell_list to inspect the cells and engines visible to the caller.
  2. Select an engine/profile appropriate to the bounded task.
  3. Verify that the worker's cwd contains the instructions and project context it needs.
  4. Do not assume an embedded worker inherits the coordinator's MCP servers. Required servers must be configured explicitly in the Crew daemon and verified inside a fresh worker.

If no Crew tools are exposed and this skill is packaged with NexusCrew, the optional companion is documented in ../../MCP_COMPANIONS.md. Explain the missing capability and ask before installing, configuring or starting it.

Spawn, monitor and collect

  1. Call cell_spawn with a bounded task, explicit cwd, background mode and a caller-stable idempotency_key.
  2. Keep the returned crewd_thread_id; a replayed idempotency key must resolve to the existing thread rather than duplicate work.
  3. Monitor with cell_status. Use the host's loop or scheduler for waits rather than a tight manual poll.
  4. Treat idle as normal turn completion. Also handle timeout, failed, interrupted and failed_unknown; do not wait for a fictional finished state.
  5. Read cell_result and inspect exit_status, final_answer and the bounded event tail.
  6. Verify the worker's files and tests yourself before accepting code changes.

A timeout may leave partial edits. Never report success from a thread state alone.

Isolate code work

  • Do not let two mutating workers edit the same worktree concurrently.
  • Give parallel code tasks separate git worktrees.
  • Preserve unrelated user changes and review every worker diff.
  • Use follow-up tasks only when the original thread and scope remain valid.
  • Cancel only the exact thread the user authorized.

Require durable audit evidence

For audits, reviews and release gates:

  1. Choose an authorized absolute report path before spawning, preferably outside the repository being audited.
  2. Require scope, evidence, findings by severity, residual risks and a terminal verdict in the report.
  3. Require the worker callback to identify the report path and verdict.
  4. Verify that the report is a non-symlink regular file, read it completely and confirm its verdict matches the callback.
  5. Recalculate important hashes and gates independently.

Chat output or cell_result.final_answer is not a substitute for the verified report.

Use the message bus deliberately

  • cell_send is fire-and-forget.
  • cell_ask plus cell_await is appropriate when a reply is required.
  • cell_send_task starts a follow-up turn on an existing thread.
  • cell_inbox reads queued bus messages.

Transport receipts do not prove task acceptance or completion. Report only results that have been verified.

Dependencies

Bundled: nothing — this skill is documentation only.

External (you must provide):

NeedInstallProbe / failure mode
A Crew MCP fabric (companion)optional companion mcp-crewd-rs: https://github.com/DioNanos/mcp-crewd-rs — the repository's Install section is authoritative and may change; this skill deliberately does not duplicate its commands (not verified here)if the companion is not registered, the client exposes no cell_* tools; ask the client for its tool list
Client MCP registrationregister the companion's stdio command in the AI client's MCP configsame failure mode: absent tools, not a runtime error
A crew token issued by the fabriccrew token issue on the host that runs the fabric (see the companion's docs)spawns are rejected as unauthorized — the rejection names the missing authorization

Without the companion there is no worker delegation in that session: say so and suggest the companion once instead of emulating cells with raw tmux.

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.