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.
In this repository23 other files it gives its agents.
- AGENTS.mdAGENTS.md
- analyze-miniSkill
- bug-captureSkill
- build-oneSkill
- ceremony-budgetSkill
- checklist-miniSkill
- constitution-liteSkill
- context-checkSkill
- diagnose-loopSkill
- eco-modeSkill
- falsify-specSkill
- grill-with-docs-liteSkill
- handoffSkill
- lean-modeSkill
- mini-specSkill
- scope-freezeSkill
- ship-miniSkill
- teach-backSkill
- test-miniSkill
- thin-planSkill
- tool-noise-guardSkill
- verify-contractSkill
- workspace-checkpointSkill
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
- Distinctive: line 20
Use when the operator wants recurring defaults for ceremony, autonomy, verification depth, communication density, or ambiguity handling.
- Distinctive: line 23
Do not run it for every task.
- Distinctive: line 33
Do not infer durable preferences from one-off behavior, a single terse request, or temporary task pressure.
- Distinctive: line 61
Ask at most five compact questions, and only for fields that are genuinely unknown or materially affect the profile.
- Distinctive: line 63
If a project needs a local exception, record it as a project-specific note rather than silently changing the broader operator default.
- Distinctive: line 66
If persistence is wanted, place the block in an existing agent-native user or project instruction surface, or another explicitly chosen …
- Distinctive: line 97
Use this compact shape:
- Very specific: line 110
Do not create OPERATOR.md by default.
- Distinctive: line 115
Every retained field reflects an explicit operator preference.
- Distinctive: line 119
No task-specific requirement has been promoted into a durable preference.
≈ “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.
Files
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
- Establish the intended profile scope:
session,project, oruser. - 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
- Ceremony preference:
- Ask at most five compact questions, and only for fields that are genuinely unknown or materially affect the profile.
- If a project needs a local exception, record it as a project-specific note rather than silently changing the broader operator default.
- Emit one compact profile block.
- 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.
- 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.mdautomatically. - Copying repository instructions or task acceptance criteria into the profile.
- Inferring stable preferences from one conversation.
- Using
targetedverification to skip a required gate. - Using
leanceremony to ignore a named risk. - Using
safe-reversible-assumptionsfor irreversible or contract-shaping choices.
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
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.

