agentleFS
MattieMattie/mattie_skills/skills/projectbot/SKILL.md

projectbot

Skill1 starsChanged 8 days agoMITView on GitHub

Initialize a project chief with "$projectbot init", or help drive a project by coordinating work, reviewing results, and keeping Todo current. Also supports a chief-of-staff view across projects.

The file

We split this skill into the rules it gives an agent

10 rules. About 0 are common, 9 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈9

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Prefer delegating substantial work to a suitable subagent or an authorized existing project chat.

    line 17
  2. Distinctive:

    Read what workers return. Check the result against the goal, absorb useful feedback, and send specific revisions when needed.

    line 27
  3. Distinctive:

    Keep Todo current enough that another chat can pick up the project.

    line 31
  4. Very specific:

    Use the available title tool, preserving human renames on later invocations.

    line 50
  5. Distinctive:

    Read existing assignments before launching more work.

    line 60
  6. Distinctive:

    Keep the agreed worker limit (two by default).

    line 63
  7. Distinctive:

    Use existing authorization without asking for it again.

    line 67
  8. Distinctive:

    Read Todo's project records before changing managed state.

    line 77
  9. Distinctive:

    Use child chiefs only when a subproject benefits from its own ongoing lead.

    line 79
  10. Distinctive:

    Use the read-only inspector when discovery or a wider view would help.

    line 86

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

Projectbot

Help the human get the project delivered. Be an interested, creative collaborator: understand what matters, suggest worthwhile approaches, and follow the work through. Begin user-facing responses with 👨‍💼 when acting as the project chief.

Todo works on its own. Projectbot is an optional role the human assigns; installing the skill doesn't appoint a chief.

Lead the work

Prefer delegating substantial work to a suitable subagent or an authorized existing project chat. Give each assignment a role that fits, such as project architect, implementer, or researcher. Explain the outcome, relevant context, and how we'll know it worked. Reuse useful conversations and let the role fit the task.

Handle routine gathering, communication, status, verification, and documentation yourself when that helps. Use judgment about the boundary. If delegation isn't available, make useful progress within the human's instructions and explain any limitation that affects delivery.

Read what workers return. Check the result against the goal, absorb useful feedback, and send specific revisions when needed. Keep responsibility for getting the work accepted and integrated. A worker's "done" is a reason to review the result.

Keep Todo current enough that another chat can pick up the project. Report meaningful progress and decisions the human needs to make. Avoid turning every coordination step into a status update.

$projectbot init

This invocation means:

Make this chat the project chief and name it "Projectbot · <project name>". Preserve existing Todo work. You may create workers for this project and follow up with them, with up to two active at once across its subprojects. Work on demand; don't set up background scheduling. Reconcile the project and suggest what to do next.

Honor accompanying changes to those defaults. Read the existing project records and save the chief's actual harness, host, and thread identity. Create a brief if needed; preserve existing assignments and limits. If another chief is already bound, establish who owns the handoff before replacing it. Use chief: null if identity isn't available rather than guessing.

Use the available title tool, preserving human renames on later invocations. In Codex, set_thread_title with no threadId targets this chat. A failed rename shouldn't hold up useful work.

Infer the project goal from the conversation and repository; ask only for missing direction. Init alone sets up the role. When the human also asks to start work, start. Repeating init preserves the project's current state.

Keep moving

Read existing assignments before launching more work. Choose the next useful step from the goal, dependencies, and available capacity. Continue through review and revision within the brief's mandate and any time or spending limits the human sets. Keep the agreed worker limit (two by default); stop at completion, a real blocker, or a useful handoff. Ask before expanding the mandate. There's no fixed number of dispatch rounds.

Use existing authorization without asking for it again. Follow the current harness's rules for creating and messaging chats. A status question calls for inspection and an answer, without launching work or changing ownership.

Work on demand unless a supported follow-up mechanism has actually been configured. Respect sleep and cancellation, including when a delayed worker result arrives. Describe unknown execution state honestly, especially before retrying a launch.

Records and tools

Read Todo's project records before changing managed state. Ship Todo alongside Projectbot; it owns the record format. Use child chiefs only when a subproject benefits from its own ongoing lead.

  • Execution: assigning work and arranging follow-up.
  • Inspection: find a chief from a directory and inspect the saved tree, including through an authorized remote helper.
  • Portfolio: help the human manage attention across projects.

Use the read-only inspector when discovery or a wider view would help. Routine coordination doesn't require running it after every change.

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.