Skill Tracer
Skills › Knowledge Work Plugins › knowledge-synthesis

knowledge-synthesis

skill · 258 lines · Apache-2.0 · enterprise-search/skills/knowledge-synthesis/SKILL.md

The facts

Its description

Combines search results from multiple sources into coherent, deduplicated answers with source attribution. Handles confidence scoring based on freshness and authority, and summarizes large result sets effectively.

The description the agent reads to decide when to use it.

From its settingsline 3

When it starts

This skill is not user-invocable, so no ordinary thing a person says would start it on its own; it is loaded by another skill in the enterprise search flow once raw results have already been gathered from multiple sources, and it turns them into one attributed answer.

A model's summary of when it is used.

A model's reading

Who can start it

Only the agent

Only the agent starts it. It's hidden from your commands.

From its settingsline 4

Licence

Apache-2.0, from enterprise-search/LICENSE

The terms its author shares it under, which let it be shown here.

From the repositorylicence text

The text

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1---
2name: knowledge-synthesis
3description: Combines search results from multiple sources into coherent, deduplicated answers with source attribution. Handles confidence scoring based on freshness and authority, and summarizes large result sets effectively.
4user-invocable: false
5---
6
7# Knowledge Synthesis
8
9The last mile of enterprise search. Takes raw results from multiple sources and produces a coherent, trustworthy answer.

Knowledge Synthesis

The last mile of enterprise search. Takes raw results from multiple sources and produces a coherent, trustworthy answer.

Raw lines 1 to 10
Names a skill search :9
11## The Goal
13Transform this:
14```
15~~chat result: "Sarah said in #eng: 'let's go with REST, GraphQL is overkill for our use case'"
16~~email result: "Subject: API Decision — Sarah's email confirming REST approach with rationale"
17~~cloud storage result: "API Design Doc v3 — updated section 2 to reflect REST decision"
18~~project tracker result: "Task: Finalize API approach — marked complete by Sarah"
19```
21Into this:
22```
23The team decided to go with REST over GraphQL for the API redesign. Sarah made the
24call, noting that GraphQL was overkill for the current use case. This was discussed
25in #engineering on Tuesday, confirmed via email Wednesday, and the design doc has
26been updated to reflect the decision. The related ~~project tracker task is marked complete.
28Sources:
29- ~~chat: #engineering thread (Jan 14)
30- ~~email: "API Decision" from Sarah (Jan 15)
31- ~~cloud storage: "API Design Doc v3" (updated Jan 15)
32- ~~project tracker: "Finalize API approach" (completed Jan 15)
33```

The Goal

Transform this:

~~chat result: "Sarah said in #eng: 'let's go with REST, GraphQL is overkill for our use case'"
~~email result: "Subject: API Decision — Sarah's email confirming REST approach with rationale"
~~cloud storage result: "API Design Doc v3 — updated section 2 to reflect REST decision"
~~project tracker result: "Task: Finalize API approach — marked complete by Sarah"

Into this:

The team decided to go with REST over GraphQL for the API redesign. Sarah made the
call, noting that GraphQL was overkill for the current use case. This was discussed
in #engineering on Tuesday, confirmed via email Wednesday, and the design doc has
been updated to reflect the decision. The related ~~project tracker task is marked complete.

Sources:
- ~~chat: #engineering thread (Jan 14)
- ~~email: "API Decision" from Sarah (Jan 15)
- ~~cloud storage: "API Design Doc v3" (updated Jan 15)
- ~~project tracker: "Finalize API approach" (completed Jan 15)
Raw lines 11 to 34
Uses an outside tool ~~chat :15
Uses an outside tool ~~email :16
Uses an outside tool ~~cloud :17
Uses an outside tool ~~project :18
35## Deduplication

Deduplication

Raw lines 35 to 36
37### Cross-Source Deduplication
39The same information often appears in multiple places. Identify and merge duplicates:
41**Signals that results are about the same thing:**
42- Same or very similar text content
43- Same author/sender
44- Timestamps within a short window (same day or adjacent days)
45- References to the same entity (project name, document, decision)
46- One source references another ("as discussed in ~~chat", "per the email", "see the doc")
48**How to merge:**
49- Combine into a single narrative item
50- Cite all sources where it appeared
51- Use the most complete version as the primary text
52- Add unique details from each source

Cross-Source Deduplication

The same information often appears in multiple places. Identify and merge duplicates:

Signals that results are about the same thing:

  • Same or very similar text content
  • Same author/sender
  • Timestamps within a short window (same day or adjacent days)
  • References to the same entity (project name, document, decision)
  • One source references another ("as discussed in ~~chat", "per the email", "see the doc")

How to merge:

  • Combine into a single narrative item
  • Cite all sources where it appeared
  • Use the most complete version as the primary text
  • Add unique details from each source
Raw lines 37 to 53
Uses an outside tool ~~chat :46
54### Deduplication Priority
56When the same information exists in multiple sources, prefer:
57```
581. The most complete version (fullest context)
592. The most authoritative source (official doc > chat)
603. The most recent version (latest update wins for evolving info)
61```

Deduplication Priority

When the same information exists in multiple sources, prefer:

1. The most complete version (fullest context)
2. The most authoritative source (official doc > chat)
3. The most recent version (latest update wins for evolving info)
Raw lines 54 to 62
63### What NOT to Deduplicate
65Keep as separate items when:
66- The same topic is discussed but with different conclusions
67- Different people express different viewpoints
68- The information evolved meaningfully between sources (v1 vs v2 of a decision)
69- Different time periods are represented

What NOT to Deduplicate

Keep as separate items when:

  • The same topic is discussed but with different conclusions
  • Different people express different viewpoints
  • The information evolved meaningfully between sources (v1 vs v2 of a decision)
  • Different time periods are represented
Raw lines 63 to 70
71## Citation and Source Attribution
73Every claim in the synthesized answer must be attributable to a source.

Citation and Source Attribution

Every claim in the synthesized answer must be attributable to a source.

Raw lines 71 to 74
75### Attribution Format
77Inline for direct references:
78```
79Sarah confirmed the REST approach in her email on Wednesday.
80The design doc was updated to reflect this (~~cloud storage: "API Design Doc v3").
81```
83Source list at the end for completeness:
84```
85Sources:
86- ~~chat: #engineering discussion (Jan 14) — initial decision thread
87- ~~email: "API Decision" from Sarah Chen (Jan 15) — formal confirmation
88- ~~cloud storage: "API Design Doc v3" last modified Jan 15 — updated specification
89```

Attribution Format

Inline for direct references:

Sarah confirmed the REST approach in her email on Wednesday.
The design doc was updated to reflect this (~~cloud storage: "API Design Doc v3").

Source list at the end for completeness:

Sources:
- ~~chat: #engineering discussion (Jan 14) — initial decision thread
- ~~email: "API Decision" from Sarah Chen (Jan 15) — formal confirmation
- ~~cloud storage: "API Design Doc v3" last modified Jan 15 — updated specification
Raw lines 75 to 90
Uses an outside tool ~~cloud :80
Uses an outside tool ~~chat :86
Uses an outside tool ~~email :87
91### Attribution Rules
93- Always name the source type (~~chat, ~~email, ~~cloud storage, etc.)
94- Include the specific location (channel, folder, thread)
95- Include the date or relative time
96- Include the author when relevant
97- Include document/thread titles when available
98- For ~~chat, note the channel name
99- For ~~email, note the subject line and sender
100- For ~~cloud storage, note the document title

Attribution Rules

  • Always name the source type (~~chat, ~~email, ~~cloud storage, etc.)
  • Include the specific location (channel, folder, thread)
  • Include the date or relative time
  • Include the author when relevant
  • Include document/thread titles when available
  • For ~~chat, note the channel name
  • For ~~email, note the subject line and sender
  • For ~~cloud storage, note the document title
Raw lines 91 to 101
Uses an outside tool ~~chat :93
Uses an outside tool ~~email :93
Uses an outside tool ~~cloud :93
102## Confidence Levels
104Not all results are equally trustworthy. Assess confidence based on:

Confidence Levels

Not all results are equally trustworthy. Assess confidence based on:

Raw lines 102 to 105
106### Freshness
108| Recency | Confidence impact |
109|---------|------------------|
110| Today / yesterday | High confidence for current state |
111| This week | Good confidence |
112| This month | Moderate — things may have changed |
113| Older than a month | Lower confidence — flag as potentially outdated |
115For status queries, heavily weight freshness. For policy/factual queries, freshness matters less.

Freshness

RecencyConfidence impact
Today / yesterdayHigh confidence for current state
This weekGood confidence
This monthModerate — things may have changed
Older than a monthLower confidence — flag as potentially outdated

For status queries, heavily weight freshness. For policy/factual queries, freshness matters less.

Raw lines 106 to 116
117### Authority
119| Source type | Authority level |
120|-------------|----------------|
121| Official wiki / knowledge base | Highest — curated, maintained |
122| Shared documents (final versions) | High — intentionally published |
123| Email announcements | High — formal communication |
124| Meeting notes | Moderate-high — may be incomplete |
125| Chat messages (thread conclusions) | Moderate — informal but real-time |
126| Chat messages (mid-thread) | Lower — may not reflect final position |
127| Draft documents | Low — not finalized |
128| Task comments | Contextual — depends on commenter |

Authority

Source typeAuthority level
Official wiki / knowledge baseHighest — curated, maintained
Shared documents (final versions)High — intentionally published
Email announcementsHigh — formal communication
Meeting notesModerate-high — may be incomplete
Chat messages (thread conclusions)Moderate — informal but real-time
Chat messages (mid-thread)Lower — may not reflect final position
Draft documentsLow — not finalized
Task commentsContextual — depends on commenter
Raw lines 117 to 129
130### Expressing Confidence
132When confidence is high (multiple fresh, authoritative sources agree):
133```
134The team decided to use REST for the API redesign. [direct statement]
135```
137When confidence is moderate (single source or somewhat dated):
138```
139Based on the discussion in #engineering last month, the team was leaning
140toward REST for the API redesign. This may have evolved since then.
141```
143When confidence is low (old data, informal source, or conflicting signals):
144```
145I found a reference to an API migration discussion from three months ago
146in ~~chat, but I couldn't find a formal decision document. The information
147may be outdated. You might want to check with the team for current status.
148```

Expressing Confidence

When confidence is high (multiple fresh, authoritative sources agree):

The team decided to use REST for the API redesign. [direct statement]

When confidence is moderate (single source or somewhat dated):

Based on the discussion in #engineering last month, the team was leaning
toward REST for the API redesign. This may have evolved since then.

When confidence is low (old data, informal source, or conflicting signals):

I found a reference to an API migration discussion from three months ago
in ~~chat, but I couldn't find a formal decision document. The information
may be outdated. You might want to check with the team for current status.
Raw lines 130 to 149
Uses an outside tool ~~chat :146
150### Conflicting Information
152When sources disagree:
153```
154I found conflicting information about the API approach:
155- The ~~chat discussion on Jan 10 suggested GraphQL
156- But Sarah's email on Jan 15 confirmed REST
157- The design doc (updated Jan 15) reflects REST
159The most recent sources indicate REST was the final decision,
160but the earlier ~~chat discussion explored GraphQL first.
161```
163Always surface conflicts rather than silently picking one version.

Conflicting Information

When sources disagree:

I found conflicting information about the API approach:
- The ~~chat discussion on Jan 10 suggested GraphQL
- But Sarah's email on Jan 15 confirmed REST
- The design doc (updated Jan 15) reflects REST

The most recent sources indicate REST was the final decision,
but the earlier ~~chat discussion explored GraphQL first.

Always surface conflicts rather than silently picking one version.

Raw lines 150 to 164
Uses an outside tool ~~chat :155
165## Summarization Strategies

Summarization Strategies

Raw lines 165 to 166
167### For Small Result Sets (1-5 results)
169Present each result with context. No summarization needed — give the user everything:
170```
171[Direct answer synthesized from results]
173[Detail from source 1]
174[Detail from source 2]
176Sources: [full attribution]
177```

For Small Result Sets (1-5 results)

Present each result with context. No summarization needed — give the user everything:

[Direct answer synthesized from results]

[Detail from source 1]
[Detail from source 2]

Sources: [full attribution]
Raw lines 167 to 178
179### For Medium Result Sets (5-15 results)
181Group by theme and summarize each group:
182```
183[Overall answer]
185Theme 1: [summary of related results]
186Theme 2: [summary of related results]
188Key sources: [top 3-5 most relevant sources]
189Full results: [count] items found across [sources]
190```

For Medium Result Sets (5-15 results)

Group by theme and summarize each group:

[Overall answer]

Theme 1: [summary of related results]
Theme 2: [summary of related results]

Key sources: [top 3-5 most relevant sources]
Full results: [count] items found across [sources]
Raw lines 179 to 191
192### For Large Result Sets (15+ results)
194Provide a high-level synthesis with the option to drill down:
195```
196[Overall answer based on most relevant results]
198Summary:
199- [Key finding 1] (supported by N sources)
200- [Key finding 2] (supported by N sources)
201- [Key finding 3] (supported by N sources)
203Top sources:
204- [Most authoritative/relevant source]
205- [Second most relevant]
206- [Third most relevant]
208Found [total count] results across [source list].
209Want me to dig deeper into any specific aspect?
210```

For Large Result Sets (15+ results)

Provide a high-level synthesis with the option to drill down:

[Overall answer based on most relevant results]

Summary:
- [Key finding 1] (supported by N sources)
- [Key finding 2] (supported by N sources)
- [Key finding 3] (supported by N sources)

Top sources:
- [Most authoritative/relevant source]
- [Second most relevant]
- [Third most relevant]

Found [total count] results across [source list].
Want me to dig deeper into any specific aspect?
Raw lines 192 to 211
212### Summarization Rules
214- Lead with the answer, not the search process
215- Do not list raw results — synthesize them into narrative
216- Group related items from different sources together
217- Preserve important nuance and caveats
218- Include enough detail that the user can decide whether to dig deeper
219- Always offer to provide more detail if the result set was large

Summarization Rules

  • Lead with the answer, not the search process
  • Do not list raw results — synthesize them into narrative
  • Group related items from different sources together
  • Preserve important nuance and caveats
  • Include enough detail that the user can decide whether to dig deeper
  • Always offer to provide more detail if the result set was large
Raw lines 212 to 220
221## Synthesis Workflow
223```
224[Raw results from all sources]
225 ↓
226[1. Deduplicate — merge same info from different sources]
227 ↓
228[2. Cluster — group related results by theme/topic]
229 ↓
230[3. Rank — order clusters and items by relevance to query]
231 ↓
232[4. Assess confidence — freshness × authority × agreement]
233 ↓
234[5. Synthesize — produce narrative answer with attribution]
235 ↓
236[6. Format — choose appropriate detail level for result count]
237 ↓
238[Coherent answer with sources]
239```

Synthesis Workflow

[Raw results from all sources]
          ↓
[1. Deduplicate — merge same info from different sources]
          ↓
[2. Cluster — group related results by theme/topic]
          ↓
[3. Rank — order clusters and items by relevance to query]
          ↓
[4. Assess confidence — freshness × authority × agreement]
          ↓
[5. Synthesize — produce narrative answer with attribution]
          ↓
[6. Format — choose appropriate detail level for result count]
          ↓
[Coherent answer with sources]
Raw lines 221 to 240
241## Anti-Patterns
243**Do not:**
244- List results source by source ("From ~~chat: ... From ~~email: ... From ~~cloud storage: ...")
245- Include irrelevant results just because they matched a keyword
246- Bury the answer under methodology explanation
247- Present conflicting info without flagging the conflict
248- Omit source attribution
249- Present uncertain information with the same confidence as well-supported facts
250- Summarize so aggressively that useful detail is lost
252**Do:**
253- Lead with the answer
254- Group by topic, not by source
255- Flag confidence levels when appropriate
256- Surface conflicts explicitly
257- Attribute all claims to sources
258- Offer to go deeper when result sets are large

Anti-Patterns

Do not:

  • List results source by source ("From ~~chat: ... From ~~email: ... From ~~cloud storage: ...")
  • Include irrelevant results just because they matched a keyword
  • Bury the answer under methodology explanation
  • Present conflicting info without flagging the conflict
  • Omit source attribution
  • Present uncertain information with the same confidence as well-supported facts
  • Summarize so aggressively that useful detail is lost

Do:

  • Lead with the answer
  • Group by topic, not by source
  • Flag confidence levels when appropriate
  • Surface conflicts explicitly
  • Attribute all claims to sources
  • Offer to go deeper when result sets are large
Raw lines 241 to 258
Uses an outside tool ~~chat :244
Uses an outside tool ~~email :244
Uses an outside tool ~~cloud :244

From anthropics/knowledge-work-plugins at 2574e29, 2026-10-27. Skills read by DeepSeek V4.1 Flash on 2026-11-04. Summary and techniques by Claude Opus 5.5 on 2026-11-06.