agentleFS
cacardinalcacardinal/laila/.claude/skills/level-up/SKILL.md

level-up

Skill1 starsChanged 4 months agoMITView on GitHub

Weekly automation ritual — one interview, ONE shipped artifact. Trigger on "level up", "what should I automate next", "find me leverage this week", or Fridays after /os-audit. Pre-seeds from bottlenecks.md + daily notes, eliminate-first, mandatory KPI tie. Functional ("what leverage is missing?"), NOT /os-audit (structural health score).

18 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use skill-builder, explain 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

  • sunnyclinches44Skill

    explain

    Explains code using real-world analogies and ASCII diagrams

    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

The file

We split this skill into the rules it gives an agent

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

  • 0

    Common

    Most of the 16 edited versions we read keep these.

  • 8

    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:

    NOT for: /os-audit (structural score), stale-content hygiene passes, or the command channel's /audit (autonomy log)

    line 15
  2. Distinctive:

    Read, in one batch:

    line 21
  3. Distinctive:

    Ask conversationally, skipping any question the pre-seed already answered:

    line 33
  4. Distinctive:

    Default = lowest level that solves the problem.

    line 55
  5. Distinctive:

    No KPI in the goal tracker, no build.

    line 80
  6. Distinctive:

    Before declaring this skill done (and again after edits):

    line 85
  7. Distinctive:

    Idempotency test: run twice on the same candidate — second run must not duplicate the bottlenecks.md row update or the decision log entry.

    line 87
  8. Distinctive:

    L4 pushback test: ask for an autonomous email-replier on first build → skill insists on L1/L2 + Tier 3 first.

    line 89
  9. Very specific:

    After each run: if Alex corrected the output, this skill is wrong, not Alex.

    line 94
  10. Distinctive:

    If the same correction happens twice, the fix is MANDATORY before the next run.

    line 95

“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

Find one manual drag on the week, scope it ruthlessly, ship exactly one artifact. The interview teaches the framework as a side effect — after a few runs Alex spots candidates mid-week without prompting.

When to use

  • "level up", "what should I automate next", "find me leverage this week"
  • Fridays, after /os-audit (audit gaps feed Phase 0)
  • NOT for: /os-audit (structural score), stale-content hygiene passes, or the command channel's /audit (autonomy log)

Steps

Phase 0 — Pre-seed (data before questions)

Read, in one batch:

  1. knowledge/tacit/bottlenecks.md — rows from the last 14 days, plus any topic appearing 3+ times across the full history (count them)
  2. Last 7 days of state/daily-notes/
  3. state/skill-feedback.jsonl if present (skill corrections logged by session-wrap)
  4. your CLI's usage log (e.g. state/agent-usage.jsonl) if present — flag cost-heavy recurring jobs
  5. Latest state/audits/*.md — the audit's top gaps are additional candidates

Present the top 3 observed bottlenecks with frequency counts: "Here's what the data says you keep doing manually — pick one or override." Alex can override with their own candidate, but the data goes on the table first.

Phase 1 — Find the candidate (mindset interview)

Ask conversationally, skipping any question the pre-seed already answered:

  1. "What did you do 3+ times this week?" (frequency)
  2. "Anything manual, boring, or copy-paste?" (drudgery)
  3. "Anything a smart intern could handle?" (delegation)
  4. "If the workload 10x'd tomorrow, what breaks first?" (constraint)

Output: 1-3 candidates ranked by leverage, one line of "why" each. Ask Alex to pick ONE. Even if they arrive with a pre-formed idea, run the pre-seed + at least one interview check against it.

Phase 2 — Scope it (method interview)

  1. Constraint: which bottleneck does this solve? Tie back to Phase 0/1 evidence.
  2. Eliminate first (Eliminate → Automate → Delegate): "What happens if we just stop doing this?" If "nothing breaks" → exit cheerfully, mark the bottleneck row Eliminated, log the decision, STOP. Don't automate waste. Then Automate (aim for ~60% deterministic / 30% AI / 10% manual framing). Delegate last (suggest a person, log it, stop).
  3. Process map — five elements: trigger / data sources / transformations / decision points / destination. Hard stop: if Alex can't articulate any of the five — "If you can't explain the process to a person, you can't explain it to an AI. Sketch it first, come back."
  4. Autonomy level → Laila tiers:

    LevelMaps to
    L0-L2 (manual / suggested / drafted)Tier 3 — propose-and-wait
    L3 (supervised)Tier 1 — auto-execute + notify
    L4 (autonomous)Requires editing config/autonomy-rules.json — push back hard; L4 only after clean L2/L3 history and an explicit override

    Default = lowest level that solves the problem. Workflows beat agents.

  5. KPI tie (mandatory): which Goal in the CRM/goal tracker does this move, and which metric? If no goal/metric can be named: "no KPI, no build" — stop, log Deferred-with-reason.

Phase 3 — Build it

Boring-is-Beautiful ladder, in order — default = the lowest rung that solves it; Alex must explicitly choose more:

  1. Prompt-only — saved trigger phrase, zero infrastructure
  2. Deterministic script in scripts/ (+ a scheduled job if it needs to recur)
  3. AI-assisted skill in skills/ — use templates/skill-template.md, including Verification + Self-improvement sections
  4. Subagent in agents/ — LAST resort; read an existing agent file for format first

Ship exactly ONE artifact. If it's a skill, frontmatter carries bike-method-phase: 1 — manual validation first, never scheduled as a background job at phase 1.

Closing (mandatory — the triage loop)

  1. Update the chosen bottleneck's row in knowledge/tacit/bottlenecks.md: status Planned → Shipped / Eliminated / Deferred-with-reason.
  2. Log the decision: dispatch the decision-logger agent with the scoped spec (constraint, eliminate/automate/delegate outcome, process map, autonomy level, KPI) and today's date → knowledge/decisions/YYYY-MM.md.
  3. One-screen close in chat: what was scoped, what shipped, bike-method-phase-1 reminder.

Rules

  • One interview = one artifact. No multi-candidate parallel scoping.
  • Eliminate is a win, not a failure — exit cheerfully and log it.
  • L4 requires an autonomy-rules.json edit and explicit override; never default to it.
  • No KPI in the goal tracker, no build.
  • Writes only: the new artifact, the bottlenecks.md row, the decision log entry. Everything else read-only.

Verification (MANDATORY)

Before declaring this skill done (and again after edits):

  • Cold test: fresh session, "level up". It must surface 3 data-backed candidates with frequency counts from bottlenecks.md/daily notes — generic output ("you should build a brief") = fail.
  • Idempotency test: run twice on the same candidate — second run must not duplicate the bottlenecks.md row update or the decision log entry.
  • Eliminate-first test: feed an obviously eliminate-able candidate → skill exits with Eliminated status, no artifact.
  • L4 pushback test: ask for an autonomous email-replier on first build → skill insists on L1/L2 + Tier 3 first.
  • Boring test: candidate solvable with a deterministic script → ladder rung 2 recommended, not a skill or agent.

Self-improvement (MANDATORY)

  • After each run: if Alex corrected the output, this skill is wrong, not Alex. Propose the edit to this file immediately, or log {"skill": "level-up", "correction": "...", "date": "YYYY-MM-DD"} to state/skill-feedback.jsonl for the next /level-up.
  • If the same correction happens twice, the fix is MANDATORY before the next run.

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.