agentleFS
holt-osholt-os/holt/skills/level-up/SKILL.md

level-up

Skill7 starsChanged 26 days agoMITView on GitHub

A weekly working session that turns one piece of recurring manual work into something Holt does for you, and ships it before the session ends. Use as a standing ritual once memory has real facts in it.

18 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use skill-builder, build and 2 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.
  • BlockSkill

    skill-builder

    Create, edit, or inspect Berd skills stored as skill folders with SKILL.md files. Use when the user wants to build a new skill, update an existing skill, convert a workflow into a reusable skill, or decide whether instructions, scripts, references, or assets belong in a skill.

    Also in 3 projects that use this

  • Microsoft AzureSkill

    build

    Build the TypeSpec Rust emitter from source. Run this after cloning the repo, after pulling changes, or when TypeScript source files have been modified.

    Also in 3 projects that use this

  • wpankSkill

    session-handoff

    WHAT: Create comprehensive handoff documents that enable fresh AI agents to seamlessly continue work with zero ambiguity. Solves long-running agent context exhaustion problem.

    Also in 3 projects that use this

  • GoogleSkill

    grill-me

    A relentless interview to sharpen a plan or design.

    Also in 5 projects that use this

The file

We split this skill into the rules it gives an agent

8 rules. 0 are common, 6 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 16 edited versions we read keep these.

  • 6

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Read what memory already knows.

    line 23
  2. Distinctive:

    If several are tempting, choose the boring one.

    line 34
  3. Distinctive:

    Runs unattended: Only for work that is reversible and already proven by hand for a few cycles.

    line 61
  4. Distinctive:

    Start one level more cautious than feels necessary.

    line 64
  5. Very specific:

    Check the registry first with holt skill search <topic>, because the work may be done already.

    line 73
  6. Distinctive:

    Prefer a fixed sequence of steps over an open-ended agent.

    line 84
  7. Distinctive:

    Run it once, now, on genuine input, and read the output with the user.

    line 89
  8. Distinctive:

    Not dropped, it is genuinely wanted.

    line 110

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

level-up

When to use

The user has been using Holt and wants it to carry more. This is the ritual that compounds: once a week, one drain becomes one shipped capability. Run it after memory holds real facts about their work; on an empty folder, run onboard first.

The session fails if it ends in a plan. It succeeds if something exists that did not exist an hour ago.

Instructions

1. Find the constraint

Read what memory already knows. Relevant past notes are injected above; also run holt memory facts and search for the work they complain about:

holt memory search <what they keep doing by hand>

Then ask what ate their time this week, and what they did more than once. Pick one. The best candidate is frequent, rule-shaped, and low-stakes if it comes out slightly wrong. Say plainly why you picked it over the others.

If several are tempting, choose the boring one. A dull thing that runs every week beats an ambitious thing that runs once.

2. Decide what to do with it

Three options, in this order:

  • Drop it. Does this task need to exist? Work that only continues out of habit should be stopped, not automated. Ask this first and mean it; the cheapest automation is the one you do not build.
  • Automate it. Rule-shaped and repeatable, with a checkable output.
  • Hand it off. It needs judgement, relationships, or accountability a machine should not hold. Say so and move to the next candidate.

Automating something that should have been dropped makes the waste permanent and harder to see. Push back before building.

3. Map it before building

Walk the task through in the user's own words: what starts it, what information it needs, what it produces, and who sees the output. Write the steps down. If you cannot state the steps in plain sentences, it is not ready to build.

Then set how much rope it gets:

  • Drafts, you send. Anything that leaves the house: email, posts, messages.
  • Runs, you review. Produces a file or a note you read afterwards.
  • Runs unattended. Only for work that is reversible and already proven by hand for a few cycles.

Start one level more cautious than feels necessary. Moving up later is easy; un-sending is not.

4. Build it now

Pick the lightest thing that works:

  • A skill, when it is a repeatable way of thinking or writing: holt skill create <name>, then write the instructions into its SKILL.md. Check the registry first with holt skill search <topic>, because the work may be done already.
  • A routine, when it is a task worth naming and rerunning: holt routine add <name> "<task>", run it with holt routine run <name>.
  • A schedule, when it should happen without being asked: holt schedule add, or a scheduled routine. Only after it has produced good output by hand at least twice.
  • A connection, when the blocker is that Holt cannot see the material: holt hook for ambient memory in Claude Code, holt mcp setup for other tools. Sometimes the whole win is that it can finally read the thing.

Prefer a fixed sequence of steps over an open-ended agent. Predictable and slightly dumb beats clever and unrepeatable.

5. Test it on something real

Run it once, now, on genuine input, and read the output with the user. If it is wrong, fix it in this session. A capability that has never run on real data is not shipped.

Then agree how it gets switched off: which command removes it, or which file to delete. Anything that runs on a timer needs a way to stop.

6. Close the loop

  1. Save what was built and why, so next week starts informed:
    holt memory add "Built the <name> routine on <date>: <what it does, what triggers it>"
  2. Note what to watch for: the failure mode most likely to show up first.
  3. Name the single next candidate from the list you did not pick, so the next session starts with a running head start.

Example

This week: forty minutes lost to writing the same client update every Friday.

Not dropped, it is genuinely wanted. Not handed off, the facts live here. Automate it, at drafts-you-send, because it goes to a client.

Built as a routine over the folder's memory, run once against this week's real work. First draft named the wrong milestone; instructions tightened, second draft was sendable. Off switch: holt routine remove friday-update.

Watch for: it will keep sounding confident about numbers it has not been given.

Next week's candidate: the invoice chase.

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.