OpenParable
Skip to content
← Back to skills

kw:compound

Productivity

kw:compound is an Agent Skill for productivity published in the EveryInc/compound-knowledge-plugin repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Extract and save learnings from a completed knowledge work session. Saves to docs/knowledge/ so future plans automatically find them.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/EveryInc/compound-knowledge-plugin/blob/HEAD/plugins/compound-knowledge/skills/kw-compound/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/kw-compound, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Compound

Close the loop. Extract what you learned and save it where future work will find it.

When to Use

  • After completing a plan, campaign, analysis, or strategy session

  • "Compound this session", "Save what we learned", "What should we remember?"

  • After a data correction, process fix, or strategic insight

  • At the end of any meaningful work session

Process

Step 1: Identify learnings

Scan the current session for compoundable insights. Look for:

TypeSignals
Insight"We discovered...", surprising finding, counter-intuitive result
PlaybookRepeatable process that worked, step-by-step that others could follow
CorrectionWrong assumption fixed, data source clarified, definition updated
PatternSomething that keeps recurring, systemic observation

Extract 1-3 learnings max. Quality over quantity. If nothing is worth saving, say so:

"Nothing from this session seems worth saving as a standalone learning. The work is captured in the plan/deliverables."

For each learning, draft:

**Learning:** [One sentence — what we now know]
**Type:** [insight | playbook | correction | pattern]
**Why it matters:** [One sentence — how this changes future work]

Step 2: Get user approval

Present the drafted learnings and ask:

"Found [N] learnings worth saving. Review and approve?"

Show each learning with its classification. User can:

  • Approve as-is

  • Edit the wording

  • Skip individual learnings

  • Add learnings you missed

Do not save anything without approval.

Step 3: Check for duplicates

For each approved learning, search existing knowledge:

Grep: [key phrases] in docs/knowledge/
Grep: [key phrases] in docs/solutions/

If a similar learning already exists:

  • Show the existing entry

  • Ask: "Update existing or save as new?"

  • If updating, edit the existing file

Step 3.5: Check for stale knowledge

After identifying what to save, launch the stale knowledge checker:

Launch Task agent: compound-knowledge:research:stale-knowledge-checker

  • Pass: the new learning(s) being saved
  • Returns: existing entries that may be contradicted or superseded

If stale entries are found, present them to the user:

"This new learning may conflict with existing knowledge:

  • [existing file] says [X], but the new learning says [Y]
  • Recommendation: [Update / Remove / Keep both]

Want me to update the old entry?"

<critical_requirement> Agents return TEXT only. They must NOT write or delete files. Only the orchestrating compound skill writes files — both new learnings and updates to stale entries. </critical_requirement>

Step 4: Save locally

Write each learning to docs/knowledge/:

Filename: docs/knowledge/{descriptive-slug}.md

Create the directory if it doesn't exist: mkdir -p docs/knowledge/

File format:

---
type: [insight | playbook | correction | pattern]
tags: [relevant keywords for future search]
confidence: [high | medium | low]
created: [today's date]
source: [brief description of what triggered this]
---

# [Learning Title]

[2-4 sentences explaining the learning. Be specific enough that someone reading this in 3 months understands what happened and why it matters.]

## Context

[What you were doing when you discovered this.]

## Implication

[How this should change future work. Be concrete: "When doing X, always check Y first."]

Step 5: Confirm and offer next steps

## Compounded

**Saved:**
- docs/knowledge/{filename}.md

**This learning will be surfaced by /kw:plan** when future work touches:
- [list the tags that would trigger retrieval]

Use AskUserQuestion:

Question: "Learnings saved. What next?"

Options:

  1. Run /kw:plan — Start a new planning cycle (the learnings will be found)
  2. Push to Proof — Share the learnings for team review
  3. Done — Session complete

Important Rules

  • 1-3 learnings max per session. If you're saving 5 things, you're not filtering enough.

  • Approval required. Never auto-save. The user decides what's worth remembering.

  • Be specific. "Use the right data source" is useless. "Revenue metrics come from [specific dashboard], not [other source] which overcounts by ~$X" is useful.

  • Duplicates are waste. Always check before creating. Update existing entries when possible.

  • Confidence matters. Mark low if based on one data point. Mark high if verified across multiple sessions or with data.

  • Tags are for retrieval. Choose tags that /kw:plan's grep search would match on. Think: "What future question would this answer?"

Pipeline Mode

When invoked with disable-model-invocation context (e.g., from an orchestrator or automation):

  • Skip all AskUserQuestion prompts
  • Use sensible defaults for all choices
  • Write output files without waiting for confirmation
  • Proceed to the next suggested skill automatically
  • Output structured results that the calling context can parse