agentleFS
peterbamuhigirepeterbamuhigire/chwezi-dev-engine/skills/ai/ai-economic-value-engine/SKILL.md

ai-economic-value-engine

Skill31 starsChanged 18 days agoMITView on GitHub

Use when discovering, designing, prioritizing, or auditing AI-powered products for measurable business value. Applies to AI opportunity mapping, ROI cases, product strategy, client workshops, and deciding whether an AI feature should be built.

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈10

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Default to read-only analysis.

    line 35
  2. Distinctive:

    When required telemetry, evidence, execution, network access, or write authority is unavailable, return a partial result with each …

    line 39
  3. Distinctive:

    Assess feasibility: Check data readiness, integration complexity, model reliability, evaluation difficulty, security, and maintenance …

    line 90
  4. Distinctive:

    Choose architecture: Prefer deterministic workflow, RAG, analytics, or simple model call before agents or fine-tuning.

    line 91
  5. Distinctive:

    Prefer no-build, deterministic workflow, analytics, or RAG recommendations when they create more value than agents.

    line 124
  6. Distinctive:

    Never skip baseline measurement.

    line 134
  7. Distinctive:

    Never promise perfect accuracy.

    line 135
  8. Distinctive:

    Never build agents where deterministic automation or workflow design is safer.

    line 136
  9. Distinctive:

    Never ignore post-launch ownership.

    line 137
  10. Distinctive:

    Use companion AI implementation, evaluation, security, RAG, analytics, or agentic skills after the opportunity is economically justified.

    line 140

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

AI Economic Value Engine

Operating contract

Inputs

InputRequiredPurpose
Domain evidenceyesbusiness outcome, baseline process, demand volume, cost and benefit assumptions, risk constraints, and decision horizon

Outputs

  • Produce: prioritised opportunity register, value model, sensitivity cases, evidence gaps, and build/no-build recommendation.

Skill-specific outputs:

  • AI opportunity map with value, feasibility, risk, and recommended sequence.
  • Business case with assumptions, ROI model, cost drivers, and non-financial benefits.
  • AI product brief or PRD with user stories, acceptance criteria, data needs, evaluation plan, and rollout stages.
  • Architecture recommendation with model, RAG/tool/workflow choice, governance, and operating model.
  • No-build recommendation when AI cannot be justified.

Capability and permission boundaries

Default to read-only analysis. Read only scoped records; redact secrets and regulated data. Writes, execution, network calls, production configuration, customer communication, billing changes, and delegation require explicit authority and an identified owner. Never widen tenant, time-window, or system scope implicitly.

Degraded mode

When required telemetry, evidence, execution, network access, or write authority is unavailable, return a partial result with each unassessed item labelled, preserve the safest existing state, and state the evidence or approval needed to continue. Never convert missing evidence into a pass.

Decision rules

ConditionAction
Scope, owner, or threshold is missingStop the affected decision and request it
Evidence is incomplete but read-only analysis is safeProduce a qualified partial result and gap list
A mutation exceeds authority or tenant boundaryBlock it and route for approval
Evidence meets the stated thresholdIssue the output with provenance and owner

Anti-Patterns

  • Treating absent evidence as success. Fix: mark the check unassessed and name the missing source.
  • Expanding one tenant or workflow to all tenants. Fix: enforce supplied scope at every query and action.
  • Performing a production write during analysis. Fix: emit a reviewed change plan until authority is explicit.
  • Reporting a metric without population, window, or source. Fix: attach all three.
  • Hiding a failed threshold inside an average. Fix: report failure slices and the remediation owner.

Acknowledgement: Shared by Peter Bamuhigire, techguypeter.com, +256 784 464178.

<!-- dual-compat-start -->

Use When

  • A client or internal team wants AI features, AI transformation, agentic workflows, analytics, automation, or AI-powered apps.
  • The work needs prioritization by business value, feasibility, data readiness, risk, and maintainability.
  • You must turn AI capability into a proposal, PRD, roadmap, SRS, architecture, or implementation plan.

Do Not Use When

  • The request is not materially about AI value, AI product selection, AI ROI, or AI investment prioritization.
  • The user already has a committed AI feature and needs a narrower implementation, evaluation, security, RAG, or agent runtime skill.

Core Principle

AI must improve an economic system: revenue, margin, productivity, quality, speed, risk, compliance, retention, or decision accuracy. Do not recommend AI for novelty.

Required Inputs

  • Target users and business process.
  • Current pain, baseline metric, cost of the pain, and decision/action affected.
  • Available data, data owner, freshness, quality, sensitivity, and access constraints.
  • Risk tolerance, legal/compliance constraints, and human approval requirements.
  • Budget, timeline, operating owner, and success metric.

Workflow

  1. Map the workflow: Trigger, actors, data, decisions, actions, handoffs, delays, and failure points.
  2. Find AI leverage: Classify opportunities as insight, prediction, generation, extraction, search, recommendation, decision support, or action automation.
  3. Estimate value: Quantify time saved, extra revenue, reduced leakage, fewer errors, faster turnaround, lower service cost, or reduced risk exposure.
  4. Assess feasibility: Check data readiness, integration complexity, model reliability, evaluation difficulty, security, and maintenance burden.
  5. Choose architecture: Prefer deterministic workflow, RAG, analytics, or simple model call before agents or fine-tuning.
  6. Define evaluation: Set quality, cost, latency, safety, business, and adoption thresholds.
  7. Plan operations: Assign owner, monitoring, feedback loop, incident response, model/prompt update cadence, and client reporting.

Opportunity Scorecard

Score each item 1-5.

DimensionQuestion
Business valueDoes it move a financially or operationally important metric?
User pullWill users adopt it inside their real workflow?
Data advantageDo we have proprietary or hard-to-copy context/data?
FeasibilityCan current models and integrations meet the required quality?
Risk controlCan failures be detected, bounded, reversed, or escalated?
Evaluation clarityCan we prove whether it works before and after launch?
MaintainabilityCan the client or agency operate it for years?

Prioritize high-value, high-feasibility, low-regret use cases first. Defer low-value or unmeasurable ideas even if they are technically impressive.

AI Product Patterns

  • Decision cockpit: Aggregates data, explains options, and recommends next actions.
  • Knowledge worker assistant: Drafts, checks, summarizes, and retrieves from trusted sources.
  • Operational copilot: Guides staff through repeatable workflows with validation and approvals.
  • Predictive engine: Forecasts demand, churn, risk, maintenance, fraud, or cash flow.
  • Autonomous workflow: Executes bounded actions with tool contracts, audit logs, and human approval gates.
  • AI analytics layer: Turns operational data into segmentation, anomaly detection, root-cause analysis, and dashboards.

Quality Standards

  • Tie every recommendation to a measurable business, operational, risk, quality, or adoption outcome.
  • Make assumptions, baselines, data readiness, operating owner, and failure modes explicit.
  • Prefer no-build, deterministic workflow, analytics, or RAG recommendations when they create more value than agents.

Anti-Patterns

  • Recommending AI because it is technically possible rather than economically justified.
  • Treating model accuracy as the only success metric.
  • Ignoring adoption, ownership, data readiness, cost, risk, and post-launch operations.

Hard Rules

  • Never skip baseline measurement. If there is no baseline, propose how to collect it.
  • Never promise perfect accuracy. State confidence, failure modes, human review, and fallback.
  • Never build agents where deterministic automation or workflow design is safer.
  • Never ignore post-launch ownership; AI products degrade without monitoring and feedback.

References

  • Use companion AI implementation, evaluation, security, RAG, analytics, or agentic skills after the opportunity is economically justified.

Evidence Produced

CategoryArtifactFormatExample
CorrectnessAI value hypothesis and outcome ledgerMarkdown tablebaseline, intervention, attributable outcome, cost, counterfactual, uncertainty, and decision
<!-- dual-compat-end -->

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.