synthesis-application
Domain-neutral methodology for evaluating completeness and logical soundness of an extracted set of components, then transforming them into actionable guidance. Runs the "is it true / is it complete / what of it" critical evaluation pass before any final artifact is built. Checks for completeness gaps, logical consistency, contradictions, and practical applicability. Reusable across any extraction workflow - skill creation (evaluating extracted components before building SKILL.md), paper extraction (evaluating Pass 2 extraction notes before deep reading), report writing (evaluating gathered evidence before synthesis). Use when an agent has extracted structured components from a source and needs to gate-check before downstream commitment. Trigger keywords - synthesis evaluation, completeness check, logic check, critical evaluation, fact-check before synthesis, gap analysis, what is not said.
What this skill does
# synthesis-application
Critical-evaluation gate that runs after component extraction and before final artifact construction. Asks Adler's third-level questions: **"Is it true? What of it?"** Catches logical gaps, missing pieces, contradictions, and practical-applicability issues before they propagate into a downstream artifact.
The skill is invoked autonomously by an agent on a structured set of extracted components. It does not host a dialogue with the operator.
## Workflow
```
- [ ] Step 1: Completeness check — are all major component types present?
- [ ] Step 2: Logic check — do the parts cohere? Any contradictions?
- [ ] Step 3: Applicability check — can this actually be applied?
- [ ] Step 4: Gap-fill recommendations — what would the calling agent need to fill?
- [ ] Step 5: Output structured findings + a single GO / GO-WITH-GAPS / NO-GO verdict
```
## Inputs
The calling agent passes:
- `extracted_components`: a structured payload of what was extracted (terms, propositions, arguments, solutions, hypotheses, etc.). Format depends on caller.
- `purpose_context`: what this is being extracted *for*. The completeness criteria depend on it. Examples:
- `purpose=skill_construction` — caller is about to build a SKILL.md from these components
- `purpose=paper_pass_3_input` — caller is about to do a Pass 3 deep read on these components
- `purpose=evidence_synthesis` — caller is about to write a report from these components
- `domain_hint`: optional, the field the source is in.
## Output structure
```markdown
## Synthesis-and-Application Output
### Completeness check
For each major component type expected for purpose={purpose_context}:
- {Component type}: {present | partial | missing} — {one-line rationale}
- ...
### Logic check
- Gaps: {list of "the artifact jumps from A to C without explaining B" issues, or "none found"}
- Contradictions: {list of "section X contradicts section Y" issues, or "none found"}
- Hidden assumptions: {assumptions stated implicitly that should be made explicit, or "none flagged"}
- Unsupported claims: {claims without evidence or reasoning, or "none flagged"}
### Applicability check
- Concrete enough to act on: {yes | partial | no} — {rationale}
- Decision criteria specified where needed: {yes | partial | no} — {rationale}
- Edge cases covered: {yes | partial | no} — {which edges are unaddressed}
### Gap-fill recommendations
- {Specific item the caller should add or seek before downstream commitment}
- ...
### Verdict
{GO | GO_WITH_GAPS | NO_GO}
Rationale: {2-3 sentences}
```
## Component types by purpose_context
Different downstream artifacts need different inventories of components. The completeness check uses the relevant inventory.
### purpose = skill_construction
A SKILL.md needs:
- **Terms**: key concepts defined unambiguously
- **Propositions**: claims supported by evidence or reasoning
- **Arguments**: complete logical sequences from premise to conclusion
- **Solutions**: concrete examples or templates that demonstrate application
- **Decision criteria**: how to choose between alternatives where the methodology branches
- **Triggers**: when this skill should be invoked
### purpose = paper_pass_3_input
A deep-read needs:
- **Main argument**: the through-line, in 3-5 sentences
- **Big Question**: the field-level problem
- **Hypotheses**: specific claims being tested
- **Evidence inventory**: figures, tables, references that carry the argument
- **Confusions**: what didn't land in Pass 2 — the agenda for Pass 3
### purpose = evidence_synthesis
A report needs:
- **Claims**: structured propositions
- **Sources**: provenance for each claim
- **Source quality**: assessment per source
- **Conflicting evidence**: where sources disagree
- **Confidence ratings**: per-claim
For other `purpose_context` values, the calling agent should specify expected component types in the input — this skill does not silently extend the inventory.
## Logic checks — what to look for
**Gaps** — premises missing between conclusions:
- "The document jumps from A to C without explaining B."
- "Step 5 references something Step 4 doesn't establish."
**Contradictions** — internal conflicts:
- "Proposition 2 says X, but Proposition 7 says not-X."
- "The framework's Dimension 1 and Dimension 3 overlap in unstated ways."
**Hidden assumptions** — load-bearing premises that aren't surfaced:
- "The methodology assumes the user has access to PHI without saying so."
- "The framework only works at scale > 10K users — never stated."
**Unsupported claims** — assertions without backing:
- "Claims X works 80% of the time but cites no source."
The output is the list. The skill does not fix gaps — it surfaces them and recommends action.
## Applicability checks — what to look for
- **Concrete enough to act on**: an extracted "principle" like "always be data-driven" is too vague. Concrete would be "before each sprint, pull last month's metric trend and identify one delta to investigate."
- **Decision criteria specified**: when the methodology branches ("if X, do A; if Y, do B"), is X-vs-Y specified clearly enough that a different agent could follow it?
- **Edge cases covered**: what happens at the boundaries — empty input, conflicting input, error states? If silent on edges, flag.
## Common patterns
### Pattern A — Skill creation gate
`purpose=skill_construction`. Run after Step 3 (component extraction) and before Step 5 (skill construction) in a skill-creation workflow. The verdict gates whether the agent proceeds to build SKILL.md or returns to the source for more extraction.
### Pattern B — Paper Pass 3 readiness
`purpose=paper_pass_3_input`. Run after Pass 2 (content grasp) on a paper extraction. The verdict gates whether Pass 3 is worth running or whether the paper needs re-reading at Pass 2 first.
### Pattern C — Pre-synthesis evidence audit
`purpose=evidence_synthesis`. Run on a research-claim-map output before writing the synthesis report. Catches "the gathered evidence doesn't actually support the conclusion you're about to write."
## Guardrails
1. **Don't fix gaps; surface them.** This skill produces a structured list of issues and a verdict. It does not modify the extracted components. The calling agent decides what to do.
2. **Don't lower the bar on completeness when components are sparse.** GO_WITH_GAPS means "you can proceed but here's what's missing" — not "this is fine because we don't have more."
3. **Verdict matters — don't soften it.** GO / GO_WITH_GAPS / NO_GO is a discrete signal. If you mean NO_GO, write NO_GO. The calling agent's pipeline depends on it.
4. **Don't import information from outside the source.** Completeness is judged against what was extracted, not what the model knows about the topic.
## Related
- [`inspectional-reading`](../inspectional-reading/SKILL.md) — the first reading level, run before extraction begins.
- [`structural-analysis`](../structural-analysis/SKILL.md) — the second level, runs between inspectional and component extraction.
- [`research-claim-map`](../research-claim-map/SKILL.md) — for the evidence-synthesis purpose, the upstream skill that produces the structured claim-source-quality payload this skill evaluates.
- [`negative-contrastive-framing`](../negative-contrastive-framing/SKILL.md) — pairs naturally with the "what is not said" portion of the logic check.
- The skill-creator skill at `skills/skill-creator/SKILL.md` invokes this skill as its Step 4.
- [`paper-three-pass-extraction`](../paper-three-pass-extraction/SKILL.md) invokes this skill before Pass 3 to gate whether a deep read is worth it.
Related in AI Agents
skill-development
IncludedComprehensive meta-skill for creating, managing, validating, auditing, and distributing Claude Code skills and slash commands (unified in v2.1.3+). Provides skill templates, creation workflows, validation patterns, audit checklists, naming conventions, YAML frontmatter guidance, progressive disclosure examples, and best practices lookup. Use when creating new skills, validating existing skills, auditing skill quality, understanding skill architecture, needing skill templates, learning about YAML frontmatter requirements, progressive disclosure patterns, tool restrictions (allowed-tools), skill composition, skill naming conventions, troubleshooting skill activation issues, creating custom slash commands, configuring command frontmatter, using command arguments ($ARGUMENTS, $1, $2), bash execution in commands, file references in commands, command namespacing, plugin commands, MCP slash commands, Skill tool configuration, or deciding between skills vs slash commands. Delegates to docs-management skill for official documentation.
reprompter
IncludedTransform messy prompts into well-structured, effective prompts — single or multi-agent. Use when: "reprompt", "reprompt this", "clean up this prompt", "structure my prompt", rough text needing XML tags and best practices, "reprompter teams", "repromptception", "run with quality", "smart run", "smart agents", multi-agent tasks, audits, parallel work, anything going to agent teams. Don't use when: simple Q&A, pure chat, immediate execution-only tasks. See "Don't Use When" section for details. Outputs: Structured XML/Markdown prompt, quality score (before/after), optional team brief + per-agent sub-prompts, agent team output files. Success criteria: Single mode quality score ≥ 7/10; Repromptception per-agent prompt quality score 8+/10; all required sections present, actionable and specific.
adaptive-compaction
IncludedAdaptive add-on policy and recovery layer that decides WHEN to compact, prune, snapshot, or fork -- replacing fixed-percent auto-compaction across Claude Code, Codex, and MCP-capable hosts. Trigger on auto-compact timing or damage: "when should I compact", "is it safe to compact now or start a fresh session", "auto-compact fires too early/mid-task", "switching to an unrelated task but the window still has space", "context rot", "answers get worse the longer the session runs", "the agent forgot the plan or my decisions after it summarized", "add a layer on top that manages context without changing the agent", raising autoCompactWindow to give the policy room, or installing/tuning a cross-tool compaction policy or PreCompact hook -- even when "compaction" is never said but the problem is context-window pressure or post-summarization memory loss. Do NOT use to summarize a conversation, build RAG, write a summarization prompt (decides WHEN not HOW), or answer max-context-length trivia.
agent-skill-creator
IncludedCreate cross-platform agent skills from workflow descriptions. Activates when users ask to create an agent, automate a repetitive workflow, create a custom skill, or need advanced agent creation. Triggers on phrases like create agent for, automate workflow, create skill for, every day I have to, daily I need to, turn process into agent, need to automate, create a cross-platform skill, validate this skill, export this skill, migrate this skill. Supports single skills, multi-agent suites, transcript processing, template-based creation, interactive configuration, cross-platform export, and spec validation.
llm-wiki
IncludedUse when building or maintaining a persistent personal knowledge base (second brain) in Obsidian where an LLM incrementally ingests sources, updates entity/concept pages, maintains cross-references, and keeps a synthesis current. Triggers include "second brain", "Obsidian wiki", "personal knowledge management", "ingest this paper/article/book", "build a research wiki", "compound knowledge", "Memex", or whenever the user wants knowledge to accumulate across sessions instead of being re-derived by RAG on every query.
skill-master
IncludedAgent Skills authoring, evaluation, and optimization. Create, edit, validate, benchmark, and improve skills following the agentskills.io specification. Use when designing SKILL.md files, structuring skill folders (references, scripts, assets), ingesting external documentation into skills, running trigger evals, benchmarking skill quality, optimizing descriptions, or performing blind A/B comparisons. Keywords: agentskills.io, SKILL.md, skill authoring, eval, benchmark, trigger optimization.