po4yka/llm-wiki-skills / skills/llm-wiki-claim-anchors
llm-wiki-claim-anchors
VerifiedInsert deterministic claim and source anchor IDs after evidence has been inspected. Use when the user wants stable claim IDs, source anchor IDs, support-label formatting, anchor validation, or reproducible claim references; route missing-evidence investigation to llm-wiki-provenance.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.0 KB |
| references/docs/provenance/claim-anchors.md | markdown | 2.6 KB |
| scripts/validate-claim-anchors.mjs | script | 5.4 KB |
references/docs/provenance/claim-anchors.md
View on GitHub# Claim-level provenance anchors
> Status: draft
> Scope: deterministic Markdown convention for claim-level provenance in LLM-Wiki pages.
## Thesis
Page-level provenance is useful but not enough for high-trust knowledge. Important claims need stable anchors that can be audited, refreshed and linked back to raw sources.

## Anchor format
Use deterministic anchors:
```markdown
- Claim text. ^claim-20260706-001
- Support: extracted
- Source: `raw/sources/example.md` ^src-20260706-001
```
Allowed support values:
```text
extracted | inferred | ambiguous | synthesis | unsupported | conflicting
```
## Rules
1. Claim anchors start with `^claim-YYYYMMDD-NNN`.
2. Source anchors start with `^src-YYYYMMDD-NNN`.
3. Each claim anchor must be followed within three lines by a `Support:` line.
4. Anchors must be unique across real Markdown content.
5. Anchors inside fenced code examples are ignored by the validator.
6. Do not fabricate anchors for sources the agent did not inspect.
7. Use `unsupported` instead of forcing weak evidence to fit a claim.
## Example
```markdown
- Good answers should be filed back into the wiki. ^claim-20260706-002
- Support: extracted
- Source: `raw/sources/llm-wiki-idea.md` ^src-20260706-002
```
## Validator
Run the default repository-wide check:
```bash
node scripts/validate-claim-anchors.mjs
```
Run a scoped check:
```bash
node scripts/validate-claim-anchors.mjs wiki examples/minimal-vault/wiki
```
Show usage:
```bash
node scripts/validate-claim-anchors.mjs --help
```
The validator:
- preserves line numbers while ignoring fenced code blocks;
- rejects duplicate claim anchors and source anchors;
- requires each claim anchor to have a nearby `Support:` line;
- accepts optional path arguments, including external vault paths, for scoped validation;
- ignores files with `<!-- claim-anchor-validator: ignore-file -->`;
- ignores the line after `<!-- claim-anchor-validator: ignore-next -->`.
## Review workflow
1. `llm-wiki-provenance` finds unsupported or high-impact claims.
2. `llm-wiki-claim-anchors` adds deterministic anchors.
3. `node scripts/validate-claim-anchors.mjs` checks uniqueness and support lines.
4. `llm-wiki-conflict-resolver` handles conflicting claims.
## Failure modes
- Anchors without source inspection create false trust.
- Generated summaries citing other generated summaries are not enough for verified claims.
- Claim IDs that are rewritten during refactors break audit history.
- Fenced examples should not consume real claim IDs or create false duplicate failures.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |