agentleFS
akunzaiakunzai/agent-skills/skills/tech-lead/SKILL.md

tech-lead

Skill5 starsChanged 54 days agoMITView on GitHub

Lead implementation as a tech lead: slice the work, brief subagent implementers in isolated git worktrees, and accept the result in the primary session.

10 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use data-analyst.

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.
  • ClineSkill

    data-analyst

    Act as an interactive data analyst for ClickHouse-backed analytics. Use when the user asks questions about internal data, metrics, dashboards, telemetry, active users, revenue, funnels, trends, distributions, or wants an analyst-style conversation, ad hoc SQL, charts, or a data export against ClickHouse (local or ClickHouse Cloud).

    Also in 3 projects that use this

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. 0 are common, 12 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 7 edited versions we read keep these.

  • 12

    Distinctive

    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:

    Check scope/durability with the user unless settled.

    line 21
  2. Distinctive:

    Done: when each slice has a name, the files it may touch, a parallel/serial mark and durability answer, and earns its own implementer by …

    line 27
  3. Distinctive:

    Done: when every parallel-marked slice is confirmed under a cap or serial with a reason.

    line 33
  4. Distinctive:

    Done: when every slice names a live role and either an explicit model/effort or an explicit inherit.

    line 44
  5. Very specific:

    Put absolute SKILL.md paths in the brief.

    line 50
  6. Distinctive:

    Done: when the brief lists those paths, or lists none, and a slice with visual evidence carries an Evidence capture scenario.

    line 54
  7. Distinctive:

    Prefer harness-native worktree or cwd isolation.

    line 58
  8. Distinctive:

    Done: when each in-flight slice has a worktree path and a branch.

    line 62
  9. Distinctive:

    Done: when each dispatched slice has a live handle, no wave exceeded the cap, and its brief split facts/assumptions and (test/audit) held …

    line 72
  10. Distinctive:

    When the slice is high-risk, you invoke an installed review skill (code review, over-engineering review, security) as coordinator.

    line 84
  11. Distinctive:

    Read an existing review artifact's findings and summary.

    line 86
  12. Distinctive:

    Done: when every slice is accepted or parked with a recorded reason.

    line 88
  13. Distinctive:

    Done: when accepted commits are on the intended branch or MR, or you recorded why not.

    line 94

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

Tech Lead

You are the tech-lead. Implementers write code. You write the brief, isolate work, and accept.

Stay in primary for architecture decisions, cohesive serial edits, and single-file changes; delegate only when parallelism pays for it or when a bounded slice warrants a cheaper role or fresh context. Bounded investigation (search, facts) uses the platform's cheap named workers when those roles exist; tests, builds, and lint run in primary, which reads their output.

1. Slice

Check scope/durability with the user unless settled.

Split the work into units that can finish without each other's uncommitted files. For every pair that shares a path (in-review included), record whether the overlap is semantic (same meaning) or mechanical (lockfile regeneration).

Slice no finer than parallelism pays for. A serial slice that lands in the same review as the one it waits on merges into it, and a shared interface stays in one slice with the consumers that shape it; split apart, the brief would fix the interface before its callers could inform it. Ask how many PRs/MRs the user wants to review: that groups slices, it does not split them.

Done when each slice has a name, the files it may touch, a parallel/serial mark and durability answer, and earns its own implementer by running in parallel or needing a different role or model.

2. Confirm parallelism

Fewer than two parallel-marked slices: skip to step 3. Otherwise ask the user whether to parallelize and at what cap, then have a read-only worker scan for conflict signals first. Named: Parallel cap, Parallel-conflict signals — references/brief-elements.md.

Done when every parallel-marked slice is confirmed under a cap or serial with a reason.

3. Live capability

From this turn's system prompt and tool schemas, pick for each slice:

  • the cheapest model and effort the harness exposes that can finish that slice
  • an implementer role from the live list (general-purpose or equivalent)

Omitting the model parameter inherits the session model; do that only for high-judgment slices. Mechanical slices get an explicit cheaper pick.

Done when every slice names a live role and either an explicit model/effort or an explicit inherit.

4. Implementation skills

From skills this session can already see (harness skill list, or skills ls --json where present), pick 0–N whose descriptions match the slice and that teach how to implement (tests, toolchain, domain procedure). Review and audit skills wait for step 7.

Put absolute SKILL.md paths in the brief. That list is the full set the implementer reads.

A slice whose acceptance includes screenshots or a recording gets that evidence at step 7, from a scenario you write now into its acceptance. Named: Evidence capture — references/brief-elements.md.

Done when the brief lists those paths, or lists none, and a slice with visual evidence carries an Evidence capture scenario.

5. Isolate

Prefer harness-native worktree or cwd isolation. Lacking that, git worktree add beside the repo or in the harness default directory, named after the slice.

You create, collect, and remove worktrees. Each implementer receives one existing path. An overlapping slice branches off the other's, not default.

Done when each in-flight slice has a worktree path and a branch.

6. Brief and dispatch

One implementer per slice. Confirmed-parallel slices dispatch in waves of at most step 2's cap; the rest one at a time.

The brief is the slice: scope, allowed files, constraints, acceptance, skill paths from step 4, worktree and branch, and when to stop and return. The implementer may commit in its worktree.

Named: Wave dispatch, Facts vs assumptions, Defect-report shape (test/audit) — references/brief-elements.md.

Done when each dispatched slice has a live handle, no wave exceeded the cap, and its brief split facts/assumptions and (test/audit) held defect-report shape.

7. Accept

On return, record every item:

  • brief constraints held
  • claimed verification actually ran
  • visual evidence: the Evidence capture scenario ran in a fresh context, and you judged its captures
  • ship, ask the user, or resume the same implementer with findings
  • a defect report: verify; ticket only with user agreement

When the slice is high-risk, you invoke an installed review skill (code review, over-engineering review, security) as coordinator.

Read an existing review artifact's findings and summary. Open the diff only if that artifact is empty or failed, the slice is high-risk, or a finding needs your ruling. Axes that review already completed stay closed.

Done when every slice is accepted or parked with a recorded reason.

8. Integrate

You push, open the MR/PR, merge, and remove the worktree, branch, and slice-only resources; rebase after merge. Confirm with the user first when the project requires it.

Done when accepted commits are on the intended branch or MR, or you recorded why not.

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.