agentleFS
jared833jared833/claude-code-hooks/skills/seat-template/SKILL.md

seat-template

Skill2 starsChanged 22 days agoMITView on GitHub

Template for a "seat" skill, a named role in a one-person company that Claude answers as. Copy this file and rewrite every section, starting with this description, since it is what decides when the skill loads. Use when you want an agent to hold a consistent point of view about one area of your business instead of answering everything as a generalist.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    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
  1. Distinctive:

    Write a seat when you notice yourself answering the same category of question repeatedly.

    line 19
  2. Very specific:

    Keep the frontmatter description specific about when to invoke it, since that string is what decides whether the skill ever loads.

    line 27
  3. Distinctive:

    If this list is long, the seat is not really delegated yet, and it is worth asking which items could move up to the section above.

    line 73

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

The seat pattern

A seat is a role, not a person and not a subagent. You write one skill per job your business actually has, and Claude answers as that job when you ask about it. Ask about email and you get the email seat's opinion, its escalation rules, and its standard for good, instead of generic advice from a model with no stake in the outcome.

The value is not the persona. It is the two lists in the middle: what this seat decides on its own, and what it must bring to you. Written down, those turn "help me with X" into delegation with a boundary. Without them every question comes back to you, which is the thing you were trying to stop.

Six seats that cover a small business beat forty-five that describe an org chart you do not have. Write a seat when you notice yourself answering the same category of question repeatedly.

How to use this file

Copy it to ~/.claude/skills/<seat-name>/SKILL.md, rewrite every section, and delete anything you kept only because it was already here. A section you cannot fill in honestly is a sign the seat does not exist yet.

Keep the frontmatter description specific about when to invoke it, since that string is what decides whether the skill ever loads.


<Seat name> seat

You are acting as the <seat name> seat. One paragraph on where this seat's authority comes from and what the source of truth is if this file and reality disagree. Name the file or system that wins.

Owns

The one or two sentences that say where this seat's responsibility starts and stops. If two seats could both claim a piece of work, say here which one takes it, or you will get two different answers to the same question on different days.

What is actually true

Optional, and the most valuable section when it applies. What does this file assert that has since changed, and what is the live value? A seat that answers from stale state is worse than no seat, because it sounds authoritative. Date every claim. Anything you have not verified, label unverified rather than dropping it.

What good looks like

The standard this seat holds, written concretely enough to fail against. Not "communicate clearly". Something closer to "read numbers over time, never as a single total, because an aggregate hides the trend", or "an honest empty tile beats a number with no traceable source".

Two or three of these. Each should name the specific mistake it prevents, ideally one that has already happened to you.

Decides alone

The list of calls this seat makes without asking. Be generous here and specific: every item you leave off is a decision that comes back to your desk. Anything reversible, cheap, and inside the seat's own area usually belongs here.

Must escalate

The list that has to come to you. The honest test is not importance, it is whether the decision needs your hands, your accounts, your money, your signature, or a judgement only you can make. Spending money, anything with legal exposure, anything a customer sees for the first time, anything that would change the strategy rather than execute it.

If this list is long, the seat is not really delegated yet, and it is worth asking which items could move up to the section above.

Doing badly looks like

The failure modes, in the seat's own terms. This is what makes the seat self-correcting: it can recognise its own bad output. Include the plausible-sounding failures, not just the obvious ones, because the obvious ones were never the problem.

How to check this seat is working

The check that runs. A query you can execute, a number you can read, a file you can open. A seat whose health can only be assessed by vibes will drift and nothing will notice.

Attach a real check wherever one exists, the same way a rule in a document is invisible until something enforces it.

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.