
toc-builder
Build a rigorous Theory of Change for MEL/SRHR programmes following Vogel (2012) DFID criteria and van Eerdewijk et al. (2017) KIT feminist ToC model. Use when Ane asks for a "theory of change", "ToC", "programme logic", "change pathway", "pathway analysis", or similar. Produces articulated outcomes, preconditions, assumptions (tested vs untested), contribution questions, and an evidence plan. Flags missing feminist political economy analysis.
- Installs
- 645
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/gasserane/personal-skills --skill toc-builder- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads toc-builder automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Theory of Change Builder
A ToC is not a logic model with arrows. It is an argument about how change happens, with the assumptions made visible and testable. This skill enforces that standard.
When to use
Trigger for theory-of-change work: new programme design, ToC revision, pathway analysis, programme logic review, funder-required ToC submissions, or ToC critique.
Do not trigger for routine results frameworks, logframes, or indicator lists — those are downstream of the ToC.
Required inputs
Ask in one batch. Do not start drafting without the first four.
- Long-term outcome or vision: the change Ane wants the programme to contribute to, stated in language the target population would recognise (required)
- Target population and context: who, where, what constraints shape their lives (required)
- Programme scope: what interventions the programme can actually deliver (required)
- Timeframe: short (12 mo), medium (3 yr), long (5-10 yr) markers (required)
- Existing analysis: prior ToC, needs assessment, or evaluation findings (optional)
- Feminist political economy analysis: who holds power in this system, how gender and other axes shape access (optional but required for SRHR; will prompt if missing)
Method
Work backward from the long-term outcome. Never forward from activities.
Step 1 — articulate the vision
Write the long-term outcome as one sentence. Must be specific enough to be falsifiable. "Improved SRHR outcomes" fails. "Adolescent girls in [region] access quality contraception within 30 minutes' travel, without third-party consent" passes.
Step 2 — identify preconditions
What must be true for the long-term outcome to hold? List preconditions at medium-term and short-term horizons. Each precondition is itself a change state, not an activity.
Step 3 — surface the causal links
For every link between preconditions, name:
- Causal claim: why does A lead to B in this context?
- Assumption: what must be true, outside the programme's control, for A to actually lead to B?
- Evidence status: tested (cite the source), plausible (cite the framework), or untested (flag for evidence gap)
Step 4 — apply the feminist political economy lens
Do not skip this, even if the programme is not labelled SRHR. For each node:
- Whose interests does this change serve? Whose interests does it threaten?
- What power relations must shift for this change to stick?
- Which voices defined this outcome? Who was consulted? Who co-designed?
If these questions cannot be answered, mark the precondition with ⚠️ Feminist political economy analysis missing.
Step 5 — identify threats to the ToC
From Mayne (2019): what alternative explanations would account for the expected change if the programme were not running? What other contributions are likely? Name them.
Step 6 — define the contribution question
State the evaluative question the ToC must eventually answer. Follow Mayne (2019) phrasing: "To what extent and in what ways did the programme contribute to [outcome], given other contributions and context?"
Step 7 — plan the evidence
For each assumption, name:
- What would confirm it?
- What would disconfirm it?
- What data source could provide that evidence?
- When will the ToC be revisited in light of the evidence?
Output structure
Produce a ToC document with these sections under these H2s:
- Vision — one sentence, as described in Step 1
- Context and population — two paragraphs max
- Pathway diagram — text representation: each precondition as a node, each link described in one sentence. If the user needs a visual, produce Mermaid source.
- Preconditions by horizon — three columns (short / medium / long), each precondition one line
- Causal claims and assumptions — table: From → To, Causal claim, Assumption, Evidence status
- Feminist political economy analysis — per-node power and participation notes
- Threats to the ToC — rival explanations and other contributions
- Contribution question — one sentence
- Evidence plan — table: Assumption, Confirming evidence, Disconfirming evidence, Data source, Revisit date
- Data gaps —
⚠️ Data gap:entries for anything missing
Citation requirements
Every framework claim cites author and year. Mandatory versions:
- Vogel (2012) "Review of the Use of 'Theory of Change' in International Development" (DFID)
- van Eerdewijk et al. (2017) "White Paper: A Conceptual Model of Women and Girls' Empowerment" (KIT)
- Mayne (2019) "Revisiting the Contribution Question" Evaluation 25(3)
- Cornwall & Rivas (2015) for feminist framing when relevant
Writing rules
Follow CLAUDE.md house style. No hedging in causal claims — if the claim is uncertain, state that the evidence is untested. No logical leaps — if Step 3 cannot name the causal mechanism, mark the link as ⚠️ Untested mechanism.
Limitations
This skill does not generate indicators. Route to indicator-designer after the ToC is stable. It does not replace stakeholder consultation — it structures the analysis Ane brings from that consultation.
Edit-preservation protocol
If Ane references an existing output by path and asks to improve, iterate, or expand it, the protocol activates. Read the file first, edit scope-bounded via the Edit tool, preserve out-of-scope content byte-identical, and return the EDIT-PRESERVATION DELIVERY summary.
Apply mel_wiki/wiki/concepts/edit-preservation-protocol.md when target file exists.
FAQ
What does the toc-builder skill do?
Build a rigorous Theory of Change for MEL/SRHR programmes following Vogel (2012) DFID criteria and van Eerdewijk et al. (2017) KIT feminist ToC model. Use when Ane asks for a "theory of change", "ToC", "programme logic", "change pathway", "pathway analysis", or similar. Produces articulated outcomes, preconditions, assumptions (tested vs untested), contribution questions, and an evidence plan. Flags missing feminist political economy analysis.
How do I install toc-builder?
Run npx skills add https://github.com/gasserane/personal-skills --skill toc-builder in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/toc-builder/ (personal) or .claude/skills/toc-builder/ (project).
Which AI agents can use toc-builder?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is toc-builder safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains toc-builder?
It is published by gasserane in gasserane/personal-skills. It has 645 recorded installs.
More from gasserane/personal-skills
journal-reflection
gasserane/personal-skills
Guide Ane through structured reflection at end of day, end of week, after a decision, or after new learning material, producing Obsidian-compatible markdown and writing to the vault journal when the path is reachable. Use on 'journal', 'reflect on today', 'weekly review', 'after-action review', or asks that reference writing to the Obsidian vault. For a quick 4-line post-deliverable capture use /learned instead.
evidence-synthesis
gasserane/personal-skills
Conduct a rigorous rapid evidence assessment or systematic-lite literature review for MEL/SRHR questions. Use when Ane asks for "evidence review", "literature review", "evidence synthesis", "REA", "what does the evidence say", "what do we know about", or similar. Produces a structured brief with question framing, method, findings by theme, confidence grading, and implications for programme or evaluation design. Does not invent citations.
daily-brief
gasserane/personal-skills
Produce a scannable morning briefing for Ane (Senior MEL/SRHR Specialist at IPPF). Use when the user asks for "daily brief", "morning briefing", "start of day", "what's on today", "plan my day", or similar. Assembles today's priority, calendar, overdue items, pending decisions, and an energy check. Operates on user-provided inputs by default; richer when calendar/email MCP servers are connected.
decision-memo
gasserane/personal-skills
Draft a structured decision memo for Ane. Use when the user asks for a "decision memo", "decision doc", "options paper", "recommendation brief", or equivalent. Produces a scannable document with context, options, recommendation, risks, and reversibility. Applies Ane's CLAUDE.md writing style automatically.
video-content-analysis
gasserane/personal-skills
Convert FGD/webinar/SBCC video files into a structured artefact pack (transcript, frames, manifest, Tier 1 BLUF summary) the existing MEL specialists can consume. Use when Ane asks to "analyse a video", "transcribe a focus group", "process a webinar recording", "summarise a meeting recording", or runs /analyze-video . Tiered transcription (local Whisper for sensitive; M365 Stream for internal/public). Privacy + consent validated by construction. Per-run feedback prompt feeds the self-improvement loop.
power-bi-build
gasserane/personal-skills
Build IPPF-branded Power BI artefacts from analytical input. Use when Ane asks to build, scaffold, or update a Power BI dashboard, semantic model, DAX measures, or .pbip project. Applies IPPF Visual Identity 2025 brand, MEL-standard DAX measures, and three standard page recipes (indicator dashboard, equity disaggregation, methodology card). Requires the pbi CLI (pbi-cli-tool, command name pbi) installed and Power BI Desktop running with a .pbip open.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
handoff
mattpocock/skills
Compact the current conversation into a handoff document for another agent to pick up.
domain-modeling
mattpocock/skills
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.
codebase-design
mattpocock/skills
Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.
diagnosing-bugs
mattpocock/skills
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.