Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

collecting-evidence

verified

Use when researching a specific pillar and need to create traceable evidence objects. Guides creation of YAML evidence files with semantic IDs, confidence scores, and assumptions.

View on GitHub

Marketplace

synapti-marketplace

synaptiai/synapti-marketplace

Plugin

context-ledger

product-development

Repository
Verified Org

synaptiai/synapti-marketplace

plugins/context-ledger/skills/collecting-evidence/SKILL.md

Last Verified

February 4, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/synaptiai/synapti-marketplace/blob/main/plugins/context-ledger/skills/collecting-evidence/SKILL.md -a claude-code --skill collecting-evidence

Installation paths:

Claude
.claude/skills/collecting-evidence/
Powered by add-skill CLI

Instructions

# Evidence Collection

This skill guides the creation of structured Evidence Objects for a single research pillar.

## Prerequisites

- Ledger workspace initialized (`/ledger-init` completed)
- Pillar assignment (which pillar to research)
- Research scope from `01-pillars/PILLARS.md`

## Workflow

Use TodoWrite to track these mandatory steps:

<required>
1. Load pillar scope and research questions
2. Identify evidence sources
3. Collect raw evidence
4. Create Evidence Objects with semantic IDs
5. Validate evidence quality
6. Check evidence gate (minimum 5 per pillar)
</required>

### Step 1: Load Pillar Scope

Read `01-pillars/PILLARS.md` to understand:
- Pillar priority level
- Specific research questions for this pillar
- Any scope restrictions

See [references/research-protocols.md](references/research-protocols.md) for pillar-specific protocols.

### Step 2: Identify Evidence Sources

For each research question, identify potential sources:

| Source Type | Examples | Typical Confidence |
|-------------|----------|-------------------|
| `url` | Research reports, documentation | 60-90 |
| `pdf` | Academic papers, whitepapers | 70-95 |
| `interview` | User interviews, expert calls | 50-80 |
| `internal-doc` | Company data, prior research | 60-85 |
| `experiment` | A/B tests, prototypes | 70-95 |
| `dataset` | Analytics, survey results | 65-90 |

### Step 3: Collect Raw Evidence

For each source:
1. Extract the key claim(s)
2. Note supporting quotes/data
3. Assess confidence level
4. List assumptions

**Web research protocol:**
- Use WebSearch for discovery
- Use WebFetch to retrieve and analyze content
- Track source URLs and retrieval dates
- Note if sources agree or contradict

### Step 4: Create Evidence Objects

Write YAML files to `02-evidence/<pillar>/`.

**Naming:** Use semantic IDs per [references/id-generation-rules.md](references/id-generation-rules.md).

**Schema:** See [references/evidence-object-schema.md](references/evidence-object-schema.md).

<good-

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
6151 chars