agentleFS
peterbamuhigirepeterbamuhigire/chwezi-dev-engine/skills/ai/ai-opportunity-canvas/SKILL.md

ai-opportunity-canvas

Skill31 starsChanged 18 days agoMITView on GitHub

Use when discovering and ranking AI use cases for a project or module and producing an opportunity register with impact, effort, cost, risk, and evidence gaps.

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 7 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    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
  1. Distinctive:

    Default to read-only analysis.

    line 27
  2. Distinctive:

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

    line 31
  3. Very specific:

    Use the references/ directory for deep detail after reading the core workflow below.

    line 65
  4. Distinctive:

    Invoke this skill: After project/module description, before HLD or feature planning.

    line 71
  5. Distinctive:

    Run through these questions for every major module in the system:

    line 96
  6. Distinctive:

    Do not propose building custom ML models — only LLM API integrations.

    line 201
  7. Distinctive:

    Do not propose AI for features where a simple rule/filter suffices (e.g., "flag invoices > $10,000" does not need AI).

    line 202
  8. Distinctive:

    Do not include opportunities where data does not yet exist and cannot be collected within 6 months.

    line 203

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

Operating contract

Inputs

InputRequiredPurpose
Domain evidenceyesproject or module scope, user jobs, current process metrics, available data, constraints, and decision owner

Outputs

  • Produce: ranked opportunity register, impact/effort/cost assumptions, risks, evidence gaps, and next-step recommendation.

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

  • Systematically discover and rank AI use cases for any software project or module. Produces a prioritised AI Opportunity Register with business impact, implementation effort, and cost estimates. Invoke after any project description or module...

Evidence Produced

CategoryArtifactFormatExample
Release evidenceAI Opportunity RoadmapPrioritised Markdown roadmap covering ranked AI use cases per project or moduledocs/ai/opportunity-roadmap-2026-04-16.md

References

  • Use the references/ directory for deep detail after reading the core workflow below.
<!-- dual-compat-end -->

Purpose

Identify every realistic place AI adds measurable value to a client's system. Output is an AI Opportunity Register — a ranked list of AI features with business case, effort estimate, and cost tier, ready for client presentation.

Invoke this skill: After project/module description, before HLD or feature planning.


The 10 Universal AI Opportunity Patterns

For each pattern, assess whether it applies to the current project module.

#PatternBusiness ValueTypical Token Cost Tier
1Smart SummarisationCompress reports, meeting notes, transactions into executive summariesLow
2Predictive AlertsForecast stock-outs, overdue payments, exam failures, crop risksMedium
3Intelligent SearchSemantic search across records (find "all unpaid invoices from March")Medium
4Auto-ClassificationCategorise expenses, tickets, documents, leads automaticallyLow
5Decision Support"Should I approve this loan?" with supporting evidenceMedium
6Natural Language ReportsGenerate narrative reports from raw data in plain English/LugandaMedium
7Anomaly DetectionFlag unusual transactions, attendance patterns, sensor readingsLow
8Recommendation EngineSuggest products, courses, treatments, suppliers based on historyMedium
9Conversational AssistantIn-app chat bot for staff help, policy lookup, FAQsMedium-High
10Document IntelligenceExtract data from uploaded receipts, invoices, forms, ID cardsMedium

Discovery Protocol

Run through these questions for every major module in the system:

Step 1 — Module Scan

For each module, ask:

  1. What decisions does a user make daily in this module?
  2. What data does this module accumulate over time?
  3. What manual work in this module is repetitive but requires judgement?
  4. What questions do users ask supervisors that could be answered by data?
  5. What early warnings would save this user money or time?

Step 2 — Pattern Matching

For each "yes" answer above, map it to one or more of the 10 patterns.

Step 3 — Score Each Opportunity

Score on three dimensions (1–5 each):

Dimension135
Business ImpactNice-to-haveSaves hours/weekCore competitive advantage
Data AvailabilityNo data existsPartial dataRich historical data
Implementation EffortCustom ML neededStandard LLM callSingle prompt

Priority Score = Impact × Data × (6 − Effort)

Rank opportunities by priority score descending.

Step 4 — Gate Assessment

For each opportunity, state:

  • Is this a candidate for the paid AI module (yes/no)?
  • Recommended pricing tier: Starter / Growth / Enterprise AI add-on

AI Opportunity Register Template

## AI Opportunity Register — [Project Name] — [Date]

### Module: [Module Name]

| ID | Opportunity | Pattern | Impact | Data | Effort | Score | AI Module Tier |
|----|-------------|---------|--------|------|--------|-------|----------------|
| AI-001 | [name] | [pattern #] | /5 | /5 | /5 | [calc] | [Starter/Growth/Enterprise] |

**Business Case:** [One sentence: who benefits, what they save/gain]
**Data Required:** [What data the AI needs to function]
**Cost Tier:** [Low / Medium / High — detail in ai-cost-modeling]
**Dependencies:** [Any data quality or integration prerequisites]
**Gate Default:** OFF — activated per tenant when AI module is purchased

Domain Quick-Reference: Common Opportunities

School Management (Academia Pro, similar)

  • Predict students at risk of failing before end-of-term → Decision Support
  • Summarise teacher remarks into report card narrative → Summarisation
  • Auto-classify fee payment exceptions for bursar review → Auto-Classification
  • Answer parent queries via in-app assistant → Conversational Assistant

POS / Retail (Maduuka, Longhorn)

  • Predict stock-outs 7 days in advance → Predictive Alert
  • Flag transactions that deviate from user's normal patterns → Anomaly Detection
  • Recommend reorder quantities by SKU → Recommendation Engine
  • Generate daily sales narrative for owner → Natural Language Reports

Healthcare (Medic8)

  • Flag patients overdue for follow-up → Predictive Alert
  • Summarise patient history for attending clinician → Summarisation
  • Extract structured data from uploaded lab reports → Document Intelligence
  • Suggest drug interaction warnings → Decision Support

Farm Management (Kulima)

  • Predict harvest yield from weather + soil data → Predictive Alert
  • Classify crop disease from uploaded photo description → Auto-Classification
  • Recommend fertiliser application by field zone → Recommendation Engine
  • Generate farm performance report for cooperative → Natural Language Reports

ERP / Finance (Longhorn, BIRDC)

  • Detect duplicate or anomalous payments → Anomaly Detection
  • Classify GL accounts for uploaded receipts → Auto-Classification
  • Summarise monthly P&L into board narrative → Summarisation
  • Flag budget overruns before period close → Predictive Alert

Output Format

Deliver the AI Opportunity Register as a markdown table (above template) followed by:

  1. Top 3 Quick Wins — highest score, lowest effort, implement first
  2. Top 1 Strategic Bet — highest business impact, even if effort is high
  3. Cost Overview — reference ai-cost-modeling for token estimates
  4. Recommended AI Module Tier — which opportunities bundle into Starter vs Growth vs Enterprise

What NOT to Include

  • Do not propose building custom ML models — only LLM API integrations.
  • Do not propose AI for features where a simple rule/filter suffices (e.g., "flag invoices > $10,000" does not need AI).
  • Do not include opportunities where data does not yet exist and cannot be collected within 6 months.

See also:

  • references/analytics-patterns.md — Extended analytics opportunity patterns (A1–A10) with domain maps for school, healthcare, POS, farm, and ERP — use for analytics-heavy modules
  • ai-feature-spec — Design any opportunity from this register into a full feature blueprint
  • ai-cost-modeling — Token cost estimates per opportunity
  • ai-metering-billing — How to gate and charge for AI features
  • ai-integration-section — Add AI section to SRS/PRD/HLD documents
  • ai-analytics-strategy — Analytics maturity assessment before selecting opportunities

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.