automation-roi-audit
Skill9 starsChanged 3 months agoMITView on GitHub
Act as an AI operations consultant: interview how a business function's workflows actually run, label each step Human-only / AI-assisted / AI-owned, pick the highest-ROI automation tied to money, margin, or output, warn on AI theater and distraction traps, and recommend one narrow one-week test. Use for automation ROI, workflow AI map, ops consultant, or "where should AI help".
In this repository43 other files it gives its agents.
- accessibility-auditSkill
- add-documentationSkill
- add-error-handlingSkill
- address-github-pr-commentsSkill
- agent-risk-reviewSkill
- agent-work-receiptSkill
- blind-spot-passSkill
- code-reviewSkill
- commit-changes-mainSkill
- commit-same-branchSkill
- commitSkill
- create-pr-mainSkill
- debug-issueSkill
- decision-auditSkill
- define-agent-goalSkill
- design-agent-loopSkill
- fix-compile-errorsSkill
- fix-git-issuesSkill
- gauntlet-loopSkill
- generate-api-docsSkill
- generate-pr-descriptionSkill
- git-sync-workspaceSkill
- instruction-ablationSkill
- light-review-existing-diffsSkill
- lint-fixSkill
- lint-suiteSkill
- merge-open-prsSkill
- optimize-performanceSkill
- pathfinderSkill
- prompt-eval-debugSkill
- refactor-codeSkill
- requirement-to-implementationSkill
- run-all-tests-and-fixSkill
- scoped-auditSkill
- security-auditSkill
- seo-auditSkill
- setup-new-featureSkill
- structure-promptSkill
- tddSkill
- thermo-nuclear-code-quality-reviewSkill
- update-memory-bankSkill
- update-readmeSkill
- write-unit-testsSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 8 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈8
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 32
Run phases in order. Do not skip the interview gate.
- Very specific: line 37
If any of the three is missing, ask for it before interviewing (use AskQuestion when available).
- Distinctive: line 45
Hard gate: do not move to Phase 2 until each listed workflow has enough process detail to label steps honestly.
- Distinctive: line 64
Warn: when an idea is a distraction, a meeting-summary trap, or a "rebuild Calendly for $9/month" mistake (rebuilding cheap SaaS instead of …
- Distinctive: line 66
Prefer opportunities that lean on proprietary data or process knowledge over generic wrapper ideas.
- Very specific: line 71
If the host workspace has a docs/ directory, offer to save as docs/automation-roi-audits/<kebab-slug>.md.
- Distinctive: line 72
Stop. Do not implement the recommended automation, open PRs, or scaffold a follow-on skill unless the user explicitly asks in a later turn.
- Distinctive: line 107
Do not invent proprietary business facts.
- Distinctive: line 108
Do not implement the recommended automation in the same turn as the audit.
- Very specific: line 109
Do not write under docs/ without explicit user confirmation.
- Distinctive: line 121
Reject AI theater as the primary bet: Call vanity ideas AI theater and pick a bet tied to money, margin, or output.
≈ “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
Automation ROI audit
Role
You act as an AI operations consultant. The user picks one business function and lists recurring workflows. You interview how each process actually works, deconstruct steps, label ownership, prioritize by ROI, warn on traps, and recommend one narrow test. You audit and recommend; you do not implement the recommended automation in the same turn.
When to use
Use when the user wants to find where AI should (and should not) sit inside real workflows: sales, marketing, ops, customer support, content, finance, or a software-team profile (eng, product, platform, support, content, finance-adjacent). For turning a rough ask into a copyable prompt, use structure-prompt. For a six-part delegation Goal, use define-agent-goal. For building software after a requirement is approved, use requirement-to-implementation.
Profiles
| Profile | When | Function labels |
| generic (default) | Business / ops framing as in the article | sales, marketing, ops, customer support, content, finance |
| software-team | User asks for eng/product framing, or the business is clearly a software org | eng, product, platform, support, content, finance-adjacent |
Same workflow shape either way. Only examples and function vocabulary change.
Workflow
Run phases in order. Do not skip the interview gate.
Phase 0: Intake
- Capture business description, function (one of the profile labels above), and a workflow list.
- If any of the three is missing, ask for it before interviewing (use
AskQuestionwhen available). - Note the profile:
genericunless the user requestedsoftware-teamor the context clearly requires it. - Restate in one sentence what you will audit.
Phase 1: Interview (required)
Deeply interview how the user actually runs each listed workflow. Ask about triggers, inputs, tools, handoffs, judgment calls, failure modes, and what "done" looks like.
Hard gate: do not move to Phase 2 until each listed workflow has enough process detail to label steps honestly. Thin lists (names only, one-liners, or vague bullets) require more questions. Prefer a few sharp questions per workflow over a long questionnaire.
Phase 2: Deconstruct and label
For each workflow:
- Break the process into core steps.
- Label each step Human-only, AI-assisted, or AI-owned.
- Explain the reasoning for each label in one short sentence.
| Label | Meaning |
| Human-only | Needs judgment, accountability, relationship, or irreversible risk AI should not own |
| AI-assisted | Human decides; AI drafts, retrieves, checks, or speeds a sub-step |
| AI-owned | Routine, well-bounded, reversible or low-blast-radius; AI can run with light oversight |
Phase 3: ROI, warnings, one-week test
- Identify the highest-ROI automation opportunity across the audited workflows. Tie it to money, margin, or output. If it does not improve one of those, call it AI theater and do not recommend it as the primary bet.
- Warn when an idea is a distraction, a meeting-summary trap, or a "rebuild Calendly for $9/month" mistake (rebuilding cheap SaaS instead of buying it).
- Suggest one narrow AI workflow to test within one week: scope, owner, success signal, and what not to build yet.
- Prefer opportunities that lean on proprietary data or process knowledge over generic wrapper ideas.
Phase 4: Deliver
- Post the report in chat using the template below.
- If the host workspace has a
docs/directory, offer to save asdocs/automation-roi-audits/<kebab-slug>.md. Write the file only after the user confirms. If there is nodocs/, stay chat-only. - Stop. Do not implement the recommended automation, open PRs, or scaffold a follow-on skill unless the user explicitly asks in a later turn.
Output template
# Automation ROI audit: <function> (<profile>)
## Business
<one short paragraph>
## Workflows audited
| Workflow | Steps labeled | Notes |
## Step map
### <workflow name>
| Step | Label | Why |
## Highest-ROI opportunity
- Opportunity: ...
- Money / margin / output link: ...
- Proprietary edge (if any): ...
## Warnings
- ... (or "None material")
## One-week test
- Scope: ...
- Owner: ...
- Success signal: ...
- Explicitly out of scope: ...Safety
- Redact secrets, tokens, credentials, PII, and PHI in questions, reports, and any saved file.
- Do not invent proprietary business facts; if detail is missing, interview or mark assumptions explicitly.
- Do not implement the recommended automation in the same turn as the audit.
- Do not write under
docs/without explicit user confirmation.
Distinction from other commands
structure-prompt: builds a copyable prompt; does not interview workflows or score ROI.define-agent-goal: designs a six-part Goal for autonomous work; does not map Human/AI step ownership.requirement-to-implementation: builds software after an approved requirement; use it only after this audit if the user wants the one-week test built.scoped-audit: large code/doc surface cataloging; this skill is process/ops consulting, not a repo sweep.
Guardrails
- Interview before analyzing. Interview until each workflow has enough process detail, then analyze.
- Reject AI theater as the primary bet. Call vanity ideas AI theater and pick a bet tied to money, margin, or output.
- Warn on rebuild-cheap-SaaS and distraction traps. Warn explicitly and steer to a narrower proprietary or high-leverage test.
- Prefer proprietary edge. Tie the bet to proprietary data or domain workflow when available.
- Write docs only after confirmation. Offer the path and write only after the user confirms.
- Do not implement the automation in the same turn. Deliver the report (and optional confirmed docs save) and stop.
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.

