agentleFS
forefyforefy/.context/skills/generic-utils/agent-onboarding/SKILL.md

agent-onboarding

Skill153 starsChanged 44 days agoMITView on GitHub

Onboard yourself to a repo where several agents work in parallel, syncing through a shared TODO.md. Use when joining the team on a shared codebase.

8 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 8 edited versions we read keep these.

  • 7

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If you had preexisting work assignments, give yourself an identity, like refractor-george or unit-testing-lary, otherwise ask the user why …

    line 7
  2. Distinctive:

    If there are existing TODO.md categories register yourself under one or more of them based on tasks at hand

    line 9
  3. Distinctive:

    DON'T fill data outside what the user had, except for your name and tasks

    line 12
  4. Distinctive:

    DON'T give yourself unmeaningfull name like "copilot-hal", either understand by context or ask the user

    line 13
  5. Distinctive:

    If onboarded after some work, you have your context already so no need to go looking for it, and same for your identity

    line 14
  6. Distinctive:

    Use the TODO.md to avoid conflicting in your actions with other members, and check back every time you are working on something to indicate …

    line 17
  7. Distinctive:

    If you are doing tasks under both categories just register yourself under both of them with the relevant tasks

    line 18

“Common” is measured: kept by at least 6 in 10 of the 8 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
  • You are now a part of a working force and you should be aware of the codebase, whats happening here and what are the docs and maybe some of the Makefile for extra context.
  • If you had preexisting work assignments, give yourself an identity, like refractor-george or unit-testing-lary, otherwise ask the user why he brought you to name yourself based on your first task
  • Find the repo's TODO.md file where all the other team members are, if you are the first, setup what is needed to get this started for future agents including yourself
  • If there are existing TODO.md categories register yourself under one or more of them based on tasks at hand
  • Whenever you are in the decision making, check back to TODO.md to see you are complimentary, and not contradictory or duplicative, of another agent/team members work
  • TODO.md should be gitignored if not already
  • DON'T fill data outside what the user had, except for your name and tasks
  • DON'T give yourself unmeaningfull name like "copilot-hal", either understand by context or ask the user
  • If onboarded after some work, you have your context already so no need to go looking for it, and same for your identity
  • We want quick and effective context understanding and team registration
  • a copilot / claude code session can only have one identity at a time
  • Use the TODO.md to avoid conflicting in your actions with other members, and check back every time you are working on something to indicate to other agents not to conflict with you
  • If you are doing tasks under both categories just register yourself under both of them with the relevant tasks

The structure should be:

# TODO.md

## Some task category

### [refractor-george]

- [ ] Refractoring what the user asked regarding the x structure
  - [ ] Task you were given when interacting with the human
  - [ ] Another task
  - [ ] Task you just completed

## Another task category

[possibly other agents or team members]

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.