← the whole session plugin/skills/leverage-predictor/SKILL.md
Predict the next highest leverage move for the codebase. Use when asked 'what should we work on next', 'highest impact task', 'leverage prediction', or proactively after completing a major task. Agents analyze codebase state and propose strategic improvements.
Leverage Predictor
Identify the highest-impact work opportunity. This skill is about analysis and identification — for filing a new proposal once you've found one, use /propose; for looking up or tracking proposals that already exist, use how-to-submit-and-track-proposals.
Relationship to /ix-sila-leverage-scoring: that skill's own text distinguishes what builds durable value over the next year (its 9-variable model) from "what to do THIS WEEK" — this skill is the second one. Use leverage-predictor for fast triage right after finishing something or when asked "what's next"; reach for /ix-sila-leverage-scoring when you need a deeper, more rigorous comparison between several candidate initiatives. They're meant to coexist, not compete — pick the one that matches how much weight the decision can bear.
When to Use
- After completing a major task
- When asked "what should we work on next"
- When asked for "highest impact" or "leverage prediction"
- Proactively when you notice opportunities
Workflow
1. Analyze Current State
Before proposing, gather context:
- Recent user feedback/bugs
- Analytics on user drop-off
- Known pain points
- Technical debt blocking features
- Recent commits/changes
2. Score Opportunities (0-100)
| Factor | Weight | Questions |
|---|---|---|
| User Impact | 40% | How many users affected? How badly? |
| Business Value | 30% | Whatever matters most for this product — revenue, retention, conversion, or another metric entirely. Score against the person's own confirmed priority table if one exists (see /alignment-harness:harness-setup); if not, use your best general judgment and mark the score "uncalibrated." |
| Effort Efficiency | 20% | Impact per hour of work? |
| Risk Reduction | 10% | Prevents future outages/bugs? |
Threshold: Only propose items scoring ≥60. Below that, skip.
If no priority table is confirmed yet, keep proposing — don't go silent — but label every score "uncalibrated" until the person confirms what matters most for their product.
3. Categorize
| Type | When to Use |
|---|---|
leverage-prediction |
Strategic next move |
seo-improvement |
Search visibility |
ux-refinement |
User experience |
intent-doc |
Missing documentation |
bug-hypothesis |
Suspected bug |
performance-fix |
Speed improvement |
refactor-suggestion |
Code health |
4. Write in Human-Legible Format (MANDATORY)
Every proposal MUST lead with a "What is actually happening to real people" section BEFORE any technical content. This is the /align communication format. The person reviewing it reads this section and instantly understands the problem without any code knowledge.
Rules for the human-legible section:
- ZERO code, variable names, function names, file paths, or technical jargon
- Describe the broken or missing experience from the perspective of a real person using the product
- Frame as: "When a person does X, they experience Y. What should happen is Z."
- Include certainty scores using emoji dots: 🔴 (<60%) 🟡 (60-69%) 🔵 (70-79%) 🟣 (80-89%) 🟢 (90%+ verified)
- Each claim gets:
{plain language claim} {emoji} {unique id number} {percent}% - Include a "Where this came from" section listing artifact IDs, knowledge atom IDs, intent doc slugs, or commit hashes that back each claim
- ALL technical detail (scoring tables, code references, fix paths) goes BELOW the human-legible section under a "## Technical Detail" header
Structure:
---
frontmatter with sources: field listing every artifact/KA/intent referenced
---
## What is actually happening to real people
[1-3 paragraphs, plain language, no code]
### How confident am I in this
[Certainty dots per claim]
### Where this came from
[Source references table]
---
## Technical Detail (agent reference)
[Scoring, code references, fix paths — everything technical goes here]
This shape matches what /proposal-schema already enforces — if you're about to file this proposal, it's usually simplest to hand your grounded finding straight to /propose (which chains /proposal-ground → /proposal-schema → filing) rather than reformatting it by hand here.
5. Submit for Human Review
Use /propose to file the proposal — it grounds the finding in what a real person experiences, enforces the canonical shape, and writes it to the person's own proposals location (their connected Obsidian vault, or the local folder alignment-harness records proposals prints if they don't have one). Then:
- Note the filename/ID
/proposereports - Use
how-to-submit-and-track-proposalsto look up its status later and respond to feedback - Claim and implement when approved
Good Proposal Examples
✅ Title: "Fix checkout abandonment at payment step"
- Reasoning: Analytics show 30% drop at payment. Users report confusion.
- Impact: Reduce abandonment by 15%, increase conversions
- Priority: 90
✅ Title: "Add export feature to coaching sessions"
- Reasoning: Top requested feature in feedback. Users want to share with therapists.
- Impact: Increase retention, word-of-mouth referrals
- Priority: 70
Anti-Patterns (DO NOT Propose)
❌ "Refactor X to be cleaner" (no user impact stated) ❌ "Add TypeScript to Y" (no business value) ❌ "Update dependencies" (maintenance, not leverage) ❌ "Add more tests" (unless blocking a feature)
Golden Rule: Business Impact First
NEVER propose:
- Pure refactoring without user impact
- "Nice to have" improvements
- Tech debt that doesn't affect users
- Over-engineering
ALWAYS propose:
- Changes that unblock user value
- Fixes for known user pain points
- Features that increase retention/conversion
- Performance wins users will notice
Agent Command (for prompts)
After completing this task, use the leverage-predictor skill to identify the next highest-leverage opportunity. Score by user impact (40%), business value (30%), effort efficiency (20%), risk reduction (10%). Only propose items scoring ≥60. File it via /propose.
Human Review
Proposals filed via /propose land wherever that skill's filing step points — the person's connected Obsidian vault if they have one, otherwise the local folder alignment-harness records proposals prints. Use /review-proposal or how-to-submit-and-track-proposals to look them up. There is no separate admin URL to check by default; if the person has set up their own review dashboard (see /alignment-harness:harness-setup), use that instead.
The person can approve, reject, defer, or add notes for clarification — same as any filed proposal.