Skip to content

alexanderop/commonplace-wiki / .agents/skills/wiki

Capture sources into this Commonplace wiki, answer questions from its notes, connect knowledge, or maintain its Markdown collection. Use for requests to save a source, ask the wiki, or organize existing notes.

references/note-contract.md

View on GitHub
# Authored note contract

The authoritative fields and allowed relation kinds live in [shared/wiki.ts](../../../../apps/wiki/shared/wiki.ts); the supported components and Markdown checks live in [compile-wiki.ts](../../../../apps/wiki/scripts/compile-wiki.ts). Read them before adding metadata or components. Do not introduce fields that the compiler silently strips.

A new real source uses this shape (replace the example values):

```yaml
---
noteId: example-source
title: Example source
description: A concise supported claim, or an explicit pending-capture description.
kind: source
resourceType: youtube
sourceUrl: https://www.youtube.com/watch?v=VIDEO_ID
author: Known creator
updated: 2026-10-04
tags: []
demo: false
relations: []
---
```

Use the current date for a real change. Omit unknown author/sourceUrl fields. Keep filenames equal to stable note IDs; do not rename an existing note from a changed source title. `resourceType` applies only to source notes. Use `podcast` for an episode even if its URL is YouTube, and `other` for unsupported/uncertain media. Concepts and insights have their own `kind` and cite supporting source notes.

In the body record:

- **Evidence and coverage:** what was inspected, its source URL and locations, and whether coverage is complete, partial or metadata-only.
- **Source account:** supported claims and reasoning. For metadata-only capture, say analysis is pending and omit takeaways.
- **Interpretation:** clearly attributed user observations or agent synthesis, if useful.
- **Connections:** explained links to existing notes, when justified.
- **Limitations:** unavailable transcript, excerpts only, unclear attribution or conflicting evidence.

These are content requirements, not mandatory identical headings for every medium. Store acquisition details in ignored raw provenance. Public notes must not contain private raw paths or private IDs. Use `[Topic](/notes/stable-id)` links. Preserve useful Comark components already supported by the renderer; do not invent new tags during ingestion.

### Author identity

Keep `author` when attribution is known. Source notes link this name to a derived
resource overview. Reuse `authorId` (a lowercase hyphenated ID) across an author's
sources when supplied; this keeps links stable across display-name changes and
separates namesakes. Optional `authorUrl` must be an evidenced HTTP(S) profile or
website. Keep name and website consistent for an ID; never invent attribution.
Authors and counts are derived from the selected publication audience.

For multiple contributors use `contributors: [{ id, name, roles, url }]` instead
of legacy author fields. Valid roles are `author`, `host`, `guest`, `editor`,
`translator`, `director`, `speaker`, `organization`. A role applies to the source,
not globally to the person. Reuse stable IDs, separate namesakes, and combine
multiple roles in one entry. Only credit roles supported by the inspected source.
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall