Agent skill
tool-process-audit
Diagnose a named or described business/engineering process for bottlenecks, risks, and optimization opportunities. Use when a user asks to review, map, or improve a workflow and wants concrete next steps with effort/impact tradeoffs.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/tool-process-audit
SKILL.md
Process Audit
Audit a business or engineering process end-to-end. Confirm what process is in scope, map current state, test for failure/inefficiency, and return ranked, actionable improvements.
Keep momentum high: avoid long interviews unless ambiguity or risk justifies deeper questioning.
Relationship to Other Skills
lp-do-critique: Critiques document quality. Use this skill for process reality and operational performance.lp-do-fact-find: Produces planning artifacts for feature/build work. Use this skill for process diagnosis and optimization recommendations.
Inputs
| Input | Required | Notes |
|---|---|---|
| Process name or description | Yes | One sentence is enough to start. |
| Optional focus tests | No | User-specified lenses (for example: compliance, handoffs, cost, automation). |
| Optional artifacts | No | SOPs, checklists, tickets, logs, screenshots, dashboards. |
If the user gives minimal detail, proceed with a normal walkthrough audit and clearly mark assumptions.
Operating Mode
CONFIRM -> MAP -> TEST -> RANK -> RECOMMEND
Allowed:
- Ask targeted clarifying questions (max 5 per turn)
- Infer missing details and mark confidence as
Observed,Inferred, orUnknown - Produce recommendations with explicit effort/impact tradeoffs
Not allowed:
- Stalling for perfect information
- Proposing major redesigns before mapping current state
- Presenting unverified assumptions as facts
Workflow
1) Intake
Request:
- Process name or description
- Optional artifacts (SOP, checklist, tickets, logs, screenshots)
Then reply with a one-sentence understanding and ask for confirm/correct.
2) Disambiguation (only when uncertainty exists)
If process scope is ambiguous:
- Present 2-4 candidate interpretations (
A/B/C/...), each in 1-2 sentences. - State assumptions for each candidate.
- Ask the user to select or correct.
Clarifying-question priority (max 5 in one turn):
- Primary goal/output
- Trigger/start condition
- End condition / done definition
- Roles/owners
- Tools/systems
If uncertainty is low, skip directly to confirmation and continue.
3) Scope What to Test
Ask once:
Do you need anything specific tested (for example bottlenecks, failure modes, compliance, cost, automation, UX, handoffs, controls, metrics)?
- If user specifies tests: treat them as primary lenses.
- If not: run the default walkthrough lenses in Step 5.
4) Map Current State
Build a process map:
Trigger -> Steps -> Handoffs -> Decision points -> End state
For each step, capture when available:
- owner/role
- inputs
- outputs
- tools/systems
- time/latency (or queue wait)
- dependencies
- failure modes
Use Unknown explicitly when data is missing.
5) Run Audit Lenses
Default lenses (run unless user narrows scope):
- Bottlenecks and queues (wait states, batching, WIP overload)
- Rework and defects (ambiguity, defects, repeat handling)
- Handoffs (ownership gaps, context loss, duplicate effort)
- Controls and risk (approval gaps, audit trail weakness, compliance exposure)
- Measurement (missing KPIs, no leading indicators, no feedback loop)
- Automation leverage (manual repetitive work, reconciliation, copy/paste)
- Scalability (what breaks at 2x and 10x volume)
- User experience where applicable (friction, drop-offs, unclear instructions)
6) Rank Findings
For each issue, score:
Impact(1-5)Frequency(1-5)Detectability difficulty(1-5; 5 = hard to detect)Effort to fix(S,M,L)
Priority score:
Priority = Impact x Frequency x Detectability difficulty
Sort by:
- Higher priority score
- Higher impact
- Lower effort (
SbeforeMbeforeL)
Each finding must include:
- issue statement
- root-cause hypothesis
- evidence confidence (
Observed | Inferred | Unknown) - recommended fix (concrete action)
- effort estimate (
S/M/L) - expected impact
7) Build Optimization Plan
Group recommendations into:
- Quick wins (0-2 days)
- Medium fixes (1-2 weeks)
- Structural redesign (multi-role/system changes)
For each recommendation, include an owner suggestion and a measurable success signal.
8) High-Stakes Risk Rule
If legal, financial, safety, or major compliance risk appears:
- Flag it explicitly as
High-stakes risk. - Prioritize immediate controls before optimization work.
- State what evidence is missing and what verification is needed next.
Output Contract (Required Order)
Always deliver in this exact order:
- Confirmed process definition (1-3 sentences)
- Process map (numbered steps + decision points + key handoffs)
- Issues and risks (ranked with scoring rationale)
- Optimizations (quick wins + medium + structural)
- Recommended next steps (first actions, owner suggestions, and what info would improve confidence)
Response Template
Use this compact structure:
## Confirmed process definition
...
## Process map
1. ...
2. ...
Decision points: ...
Handoffs: ...
## Issues and risks (ranked)
1. <Issue>
- Score: Impact <n> x Frequency <n> x Detectability <n> = <n>
- Confidence: Observed | Inferred | Unknown
- Root cause: ...
- Fix: ...
- Effort: S | M | L
- Expected impact: ...
## Optimizations
### Quick wins (0-2 days)
- ...
### Medium fixes (1-2 weeks)
- ...
### Structural redesign
- ...
## Recommended next steps
1. ...
2. ...
3. ...
Confidence boosters: ...
Quality Bar
- Do not stop at generic advice; every top issue needs a concrete fix.
- Keep assumptions visible and minimal.
- Prefer the smallest effective change before structural redesign.
- If evidence is thin, provide the best current audit plus a clear data-collection next step.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?