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.
In this repository23 other files it gives its agents.
- AGENTS.mdAGENTS.md
- aftermath-rewindSkill
- aiconographerSkill
- ask-socratesSkill
- check-project-nameSkill
- goal-checkSkill
- lean-proof-reviewSkill
- parallax-imageSkill
- prior-artSkill
- quiet-uxSkill
- rmddSkill
- rmdsSkill
- rmdvSkill
- rrr-review-remedy-respondSkill
- soft-skill-creatorSkill
- thought-rigSkill
- todoSkill
- verifier-systemSkill
- what-huhSkill
- what-whatSkill
- write-humanlySkill
- write-plainlySkill
- write-simplified-technical-englishSkill
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
- Distinctive: line 17
Prefer delegating substantial work to a suitable subagent or an authorized existing project chat.
- Distinctive: line 27
Read what workers return. Check the result against the goal, absorb useful feedback, and send specific revisions when needed.
- Distinctive: line 31
Keep Todo current enough that another chat can pick up the project.
- Very specific: line 50
Use the available title tool, preserving human renames on later invocations.
- Distinctive: line 60
Read existing assignments before launching more work.
- Distinctive: line 63
Keep the agreed worker limit (two by default).
- Distinctive: line 67
Use existing authorization without asking for it again.
- Distinctive: line 77
Read Todo's project records before changing managed state.
- Distinctive: line 79
Use child chiefs only when a subproject benefits from its own ongoing lead.
- Distinctive: line 86
Use the read-only inspector when discovery or a wider view would help.
≈ “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.
Files
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.
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
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.

