agentleFS
tmussertmusser/ai-engineering-skills/skills/operator-profile/SKILL.md

operator-profile

Skill6 starsChanged 3 months agoMITView on GitHub

Create a compact operator preference profile that tunes safe workflow defaults without overriding task contracts, repository instructions, safety boundaries, or required verification.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈9

    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:

    Use when the operator wants recurring defaults for ceremony, autonomy, verification depth, communication density, or ambiguity handling.

    line 20
  2. Distinctive:

    Do not run it for every task.

    line 23
  3. Distinctive:

    Do not infer durable preferences from one-off behavior, a single terse request, or temporary task pressure.

    line 33
  4. Distinctive:

    Ask at most five compact questions, and only for fields that are genuinely unknown or materially affect the profile.

    line 61
  5. Distinctive:

    If a project needs a local exception, record it as a project-specific note rather than silently changing the broader operator default.

    line 63
  6. Distinctive:

    If persistence is wanted, place the block in an existing agent-native user or project instruction surface, or another explicitly chosen …

    line 66
  7. Distinctive:

    Use this compact shape:

    line 97
  8. Very specific:

    Do not create OPERATOR.md by default.

    line 110
  9. Distinctive:

    Every retained field reflects an explicit operator preference.

    line 115
  10. Distinctive:

    No task-specific requirement has been promoted into a durable preference.

    line 119

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

Operator Profile

Purpose

Configure how AI Engineering Skills should behave for a particular operator without turning personal preferences into a second task contract.

Setup skill, not a workflow stage. Run it when preferences are first established or materially change, then let other skills consume the profile as a default.

The profile may narrow authority; it may not grant new authority.

When to use

Use when the operator wants recurring defaults for ceremony, autonomy, verification depth, communication density, or ambiguity handling.

Do not run it for every task. Skip it when the current request already gives the needed preferences or when no persistent personalization is useful.

Inputs

  • Explicit operator preferences
  • Optional existing native user/project instructions
  • Optional project-specific preferences
  • Intended profile scope: session, project, or user

Do not infer durable preferences from one-off behavior, a single terse request, or temporary task pressure.

Authority boundary

An operator profile is a preference layer, not an authorization layer.

A current explicit instruction, repository-native instruction, task contract, safety boundary, tool permission, scope freeze, verification requirement, or human gate outranks a profile default when they conflict.

The profile may make behavior stricter. It must not:

  • expand write scope, tool access, permissions, or side effects
  • weaken required verification, compatibility probes, or review gates
  • convert a human approval boundary into autonomous permission
  • override a named acceptance criterion, non-goal, or repository rule
  • hide material ambiguity merely because the operator prefers fewer questions

Workflow

  1. Establish the intended profile scope: session, project, or user.
  2. Capture only these recurring defaults:
    • Ceremony preference: lean | balanced | guarded
    • Autonomy boundary: propose-only | bounded-execution | human-gate-side-effects
    • Verification depth: targeted | standard | expanded
    • Communication density: lean | normal | explanatory
    • Ambiguity handling: ask-material | safe-reversible-assumptions
  3. Ask at most five compact questions, and only for fields that are genuinely unknown or materially affect the profile.
  4. If a project needs a local exception, record it as a project-specific note rather than silently changing the broader operator default.
  5. Emit one compact profile block.
  6. If persistence is wanted, place the block in an existing agent-native user or project instruction surface, or another explicitly chosen configuration surface. Do not invent a second instruction hierarchy.
  7. Re-run setup only when preferences materially change.

Field semantics

Ceremony preference affects tie-breaks only after task risk is understood. lean favors the smallest equally safe route. guarded may favor slightly more durable evidence when two routes protect the same named risks. It never overrides a concrete reason to use a lighter or heavier route.

Autonomy boundary is a ceiling. bounded-execution means the profile itself does not add an extra approval step inside work that is already authorized; it does not authorize tools, writes, deployment, sending, publishing, or other side effects.

Verification depth controls optional proof beyond mandatory checks. targeted stops at required evidence, standard adds cheap relevant regression proof, and expanded allows additional adjacent high-value checks when their cost is low. Required gates remain required in every mode.

Communication density controls routine response detail only. It does not suppress risks, blockers, uncertainty, exact commands, evidence, or decision-relevant tradeoffs.

Ambiguity handling applies only to non-material uncertainty. Material ambiguity that can change scope, correctness, safety, permissions, or irreversible behavior must still be surfaced.

Outputs

Use this compact shape:

OPERATOR PROFILE
Scope: session | project | user
Ceremony preference: lean | balanced | guarded
Autonomy boundary: propose-only | bounded-execution | human-gate-side-effects
Verification depth: targeted | standard | expanded
Communication density: lean | normal | explanatory
Ambiguity handling: ask-material | safe-reversible-assumptions
Project-specific notes: none | ...

Do not create OPERATOR.md by default. Persistence belongs in an existing, explicitly chosen instruction or configuration surface.

Stop conditions

  • Every retained field reflects an explicit operator preference.
  • The precedence and authority boundary are clear.
  • The profile is compact enough to remain useful as context.
  • Persistence, if requested, uses an existing explicit surface.
  • No task-specific requirement has been promoted into a durable preference.

Anti-patterns

  • Treating the profile as permission to perform actions the task did not authorize.
  • Making the profile a required first step in every workflow.
  • Creating OPERATOR.md automatically.
  • Copying repository instructions or task acceptance criteria into the profile.
  • Inferring stable preferences from one conversation.
  • Using targeted verification to skip a required gate.
  • Using lean ceremony to ignore a named risk.
  • Using safe-reversible-assumptions for irreversible or contract-shaping choices.

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.