Best for
- Build an evidence-backed business case for an AI use case or agentic workflow.
- Decide whether an AI pilot should scale, remain bounded, be redesigned, or stop.
- Review claimed AI productivity, savings, adoption, or transformation results.
magnus919/agent-skills/ai-operating-economics/SKILL.md
Use when deciding whether an AI-enabled workflow should be adopted, scaled, constrained, redesigned, or retired, and the decision must connect business outcomes, worker or user effects, quality guardrails, full operating cost, telemetry, uncertainty, and accountable governance. Do not use for a standalone financial model, infrastructure cost calculation, agent evaluation design, runtime operations, or general AI governance; route those details to the neighboring specialist skills.
Decision brief
Use when deciding whether an AI-enabled workflow should be adopted, scaled, constrained, redesigned, or retired, and the decision must connect business outcomes, worker or user effects, quality guardrails, full operating cost, telemetry, uncertainty, and accountable governance. Do not use for a standalone financial model, infrastructure cost calculation, ag…
Compatibility matrix
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Not declared | No explicit evidence | Portability before use |
| Claude Code | Not declared | No explicit evidence | Portability before use |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/magnus919/agent-skills --skill "ai-operating-economics"Inspect the Agent Skill "ai-operating-economics" from https://github.com/magnus919/agent-skills/blob/531ff6753784823c878c92b988c6e55266ce09a9/ai-operating-economics/SKILL.md at commit 531ff6753784823c878c92b988c6e55266ce09a9. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
Use this sequence for an AI initiative review. Load the detailed method and the evidence-record template when the task requires a durable artifact.
Review the “Quick Start by Need” section in the pinned source before continuing.
Review the “Choose Review Depth” section in the pinned source before continuing.
Before delivering an AI operating economics decision, verify:
Review the “Entry Points” section in the pinned source before continuing.
Permission review
The documentation asks the agent to read local files, directories, or repositories.
| Need | Load when | File |Evidence record
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 96/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 61 | Source | Repository attention, not individual Skill quality |
| Compatibility | 0 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
AI initiatives are operating interventions, not merely model purchases or ROI spreadsheets. Their value depends on what work changes, who benefits, what quality or risk changes with it, what the complete intervention costs, and whether the organization can observe and govern those changes.
This skill provides the cross-domain decision spine for evaluating an AI-enabled workflow. It does not replace financial modeling, product measurement, statistical inference, agent evaluation, runtime operations, or AI governance. It makes those inputs meet in one accountable decision record.
The core question is not “Did the model make people faster?” It is: “What changed in this workflow, for whom, at what full cost, with what outcome and countermetric evidence, and what authority should the organization grant next?”
| Starting state | Start with | Primary artifact or route |
|---|---|---|
| Idea or proposed AI workflow | Steps 1–2 | templates/ai-initiative-evidence-record.md |
| Existing pilot or outcome data | Steps 3–7 | references/evidence-method.md plus the evidence record |
| Request for broader population or side-effect authority | Steps 7–8; load references/evidence-method.md section 7a for the governance packet | Governance evidence packet plus the evidence record |
| Executive, portfolio, launch, or lifecycle review | Steps 8–9 | templates/ai-economics-review.md; route launch/runtime details onward |
| Standalone financial, statistical, telemetry, runtime, or governance implementation task | When Not to Use | Named adjacent specialist skill |
Load this skill when the user needs to:
| If the task is primarily... | Route to | This skill still contributes... |
|---|---|---|
| Financial statements, pricing, CAC/LTV, runway, or SaaS metrics | financial-modeling | The AI workflow's outcome and cost evidence can feed the model |
| Token, infrastructure, quota, capacity, or SLO-cost modeling | capacity-and-cost-engineering | The economic decision can consume the resulting cost boundary |
| Metric trees, event schemas, instrumentation QA, or product dashboards | product-analytics-and-measurement | The decision defines which outcome and countermetric evidence matters |
| Experimental design, causal inference, statistical testing, or power analysis | data-scientist | The decision specifies the claim and comparison it must support |
| Agent datasets, graders, traces, regression analysis, or telemetry implementation | agent-evals-and-observability | The decision consumes verified evaluation and telemetry evidence |
| Production rollout, runtime budgets, authority, fallback, escalation, or disablement | agent-production-operations | The decision sets the evidence and authority boundary |
| Organization-wide AI risk, policy, compliance, or governance operating models | ai-governance | The initiative record supplies an operating case and unresolved gaps |
| Launch-readiness packet or production go/no-go decision | production-readiness | The initiative disposition becomes one readiness input |
| General product governance cadence without an AI-specific value question | product-operations-and-governance | Use this skill only for the AI-specific value and operating-economics question |
Use this sequence for an AI initiative review. Load the detailed method and the evidence-record template when the task requires a durable artifact.
| Need | First action | Load next |
|---|---|---|
| Triage a claim | Name the workflow, decision, and evidence class | Steps 1–3; evidence classes are defined in Step 7 |
| Build a durable record | Copy the initiative evidence record and complete the header first | templates/ai-initiative-evidence-record.md |
| Investigate uncertain evidence | Freeze the claim table before drafting conclusions | references/evidence-method.md |
| Prepare a review | Assemble evidence, slices, cost, gaps, and disposition | templates/ai-economics-review.md |
| Mode | Use when | Minimum evidence | Output |
|---|---|---|---|
| Triage | A claim or opportunity needs a bounded first decision | Workflow, value hypothesis, one outcome, one countermetric, known gaps | Hold, with a routing/evidence plan |
| Standard | A pilot or workflow decision can change population or investment | Comparison, outcome/countermetrics, slices, cost boundary, owner, reversal path | Scale, constrain, redesign, or hold |
| High-assurance | Authority, sensitive data, material user impact, or irreversible change is involved | Standard evidence plus governance packet, human oversight, incident/revalidation, and decommissioning evidence | Scale only within an explicit authority boundary, or Hold |
Name the workflow, population, task boundary, intervention mode, baseline, decision sought, and decision owner. State whether the AI assists, recommends, routes, executes, or replaces/removes work. Define what remains human-controlled.
Do not begin with the model name or a claimed percentage. Begin with the work that changes and the decision the evidence must support.
Write a falsifiable hypothesis:
For [population] doing [workflow], [intervention] will change [outcome] by [direction/range] without exceeding [countermetric boundary], at [full operating cost boundary], compared with [baseline], over [period].
If the proposed outcome is only “productivity,” decompose it into the actual customer, employee, operational, financial, or mission outcome. If the outcome cannot be observed or credibly proxied, mark the initiative measurement-incomplete rather than inventing a proxy.
Define:
Route metric definitions and instrumentation plans to product analytics. Route statistical or causal design to data science. This skill owns the connection between the evidence and the decision, not the detailed statistical method.
Record both:
At minimum consider inference, tool use, retrieval, storage, data transfer, observability, engineering, evaluation, human review, training, support, change management, governance, security, and committed capacity. Separate fixed, variable, step-function, and avoided costs. Define the denominator precisely: task, resolved case, completed workflow, active user, customer outcome, or another meaningful unit.
Route the detailed model to capacity-and-cost-engineering or financial-modeling. Never divide total spend by an undifferentiated request count when requests have materially different resource or outcome profiles.
Choose the strongest feasible comparison before interpreting results:
Record selection effects, learning effects, concurrent initiatives, task-mix changes, worker self-selection, quality measurement gaps, and changes in pay or incentives. If the comparison cannot support the requested claim, narrow the claim rather than upgrading the method rhetorically.
Report the overall result and inspect slices that could change the decision:
Treat heterogeneous effects as a finding, not noise to average away. A tool that helps novices while harming expert quality may need differentiated assistance modes, not universal rollout.
For every material claim, label it:
| Class | Meaning | Permitted use |
|---|---|---|
| Observed | Directly measured in the target workflow with a stated method | Describe what happened within the stated scope |
| Causal estimate | Supported by a credible comparison or experiment | Attribute an effect only within the design's limits |
| Inferred | Reasoned from observed evidence and explicit assumptions | Guide a bounded hypothesis or scenario |
| Vendor-reported | Provider survey, case study, or product documentation | Establish reported adoption or available capability, not realized ROI |
| Asserted | Stakeholder or proposal claim not yet verified | Track as an assumption and evidence gap |
| Normative | Standard or framework recommendation | Define a control expectation, not an outcome claim |
Keep the source, access date, scope, version, caveat, and permitted interpretation with each claim. Load references/source-index.md for the research basis and evidence boundaries.
For each material claim, record: claim, evidence class, source and scope, what it supports, what it does not support, open challenge, and permitted language. Keep unknown claims visible; do not let a source URL or vendor report stand in for direct workflow evidence.
Every completed review must expose, in one durable artifact: the intervention and population, value hypothesis, primary outcome, countermetrics, comparison and limitations, cost boundary, relevant slices, evidence classes, missing evidence with owner, disposition, authority limit, reversal path, and review trigger.
| Evidence state | Default disposition | Next control |
|---|---|---|
| Outcome and countermetrics support a bounded expansion; cost and slices are understood | Scale | Name the next population and authority slice |
| Value is plausible but a cost, quality, subgroup, or authority boundary remains unresolved | Constrain | Limit population, task, quota, or human review |
| The mechanism creates avoidable failure or burden | Redesign | Change the workflow or control and rerun the comparison |
| Required evidence is missing or conflicting | Hold | Assign the evidence owner and review trigger |
| Value is absent or countermetrics exceed bounds | Retire | Protect affected people, migrate, and record learning |
| A material gap is accepted temporarily by a named human | Exception | Set expiry, containment, approver, and revisit condition |
Choose exactly one primary disposition:
A decision is incomplete without an owner, review date or trigger, evidence gaps, and reversal path. Route launch or runtime consequences to the appropriate specialist skill.
At the review date, compare expected versus observed outcomes, cost, quality, worker or user effects, adoption, and incidents. Preserve the updated evidence record and state whether the prior hypothesis was supported, weakened, refuted, or still unresolved. Feed verified incidents and near misses into evaluation and governance work rather than treating them as anecdotal follow-up.
| Need | Load when | File |
|---|---|---|
| Apply the full research and decision method, including comparison design and uncertainty | Evidence is incomplete, contested, or consequential | references/evidence-method.md |
| Review sources and permitted interpretations | A claim needs provenance or a source boundary | references/source-index.md |
| Fill a durable initiative record | Starting a new workflow review or pilot assessment | templates/ai-initiative-evidence-record.md |
| Prepare an executive or lifecycle review | Combining one or more initiative records for a decision | templates/ai-economics-review.md |
Before delivering an AI operating economics decision, verify:
Stop when the requested decision is supported by a durable evidence record, or when a bounded hold/escalation is the honest result. Do not continue refining prose to conceal missing evidence.
Frequently asked questions
Use when deciding whether an AI-enabled workflow should be adopted, scaled, constrained, redesigned, or retired, and the decision must connect business outcomes, worker or user effects, quality guardrails, full operating cost, telemetry, uncertainty, and accountable governance. Do not use for a standalone financial model, infrastructure cost calculation, ag…
The source record exposes this install command: npx skills add https://github.com/magnus919/agent-skills --skill "ai-operating-economics". Inspect the command and pinned source before running it.
Static rules flagged read-files in the source; the page lists the matching lines and excerpts.
Alternatives
prowler-cloud/prowler
PostgreSQL indexing best practices for Prowler: index design, partial indexes, partitioned table indexing, EXPLAIN ANALYZE validation, concurrent operations, monitoring, and maintenance. Trigger: When creating or modifying PostgreSQL indexes, analyzing query performance with EXPLAIN, debugging slow queries, reviewing index usage statistics, reindexing, dropping indexes, or working with partitioned table indexes. Also trigger when discussing index strategies, partial indexes, or index maintenance
oaustegard/claude-skills
Generate hierarchical _FEATURES.md files that describe what a codebase DOES from a user/consumer perspective, anchored to source symbols via tree-sitting. Supports large complex codebases through feature-driven decomposition into sub-feature files. Uses a multi-pass synthesis: orientation → detail → overview rewrite. Use when someone says "what does this do", "document features", "feature inventory", "_FEATURES.md", or needs to understand a codebase's purpose before modifying it. Complements tre
HKUDS/Vibe-Trading
Create, modify, and optimize quantitative trading strategies, then backtest and evaluate them.
vasilyu1983/AI-Agents-public
Guides iOS testing with XCTest, XCUITest, Swift Testing, simctl, and xcresult. Use when choosing destinations, controlling flakes, or parsing test artifacts for native apps.