Skip to content

po4yka/llm-wiki-skills / skills/llm-wiki-claim-anchors

llm-wiki-claim-anchors

Verified

Insert 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.

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.

![Diagram of an agent anchoring wiki claims to supporting sources with visible links.](../assets/preview/claim-anchors.webp)

## 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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall