Not in the top 1,000 by GitHub stars

ejklock/living-docs-skill

Living Docs — a AI agent skill that runs your project's documentation as a living system: constitution, ADRs, BDRs, PRDs, issues, research notes & Mermaid architecture diagrams under five no-drift governance invariants. OKF-formatted, stack-agnostic. Works with Claude Code, Cursor, Copilot, OpenCode & Pi.

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

skills/living-docs/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Local scripts → After Local scripts

8b675599125d → 8b675599125d

Diff text is unavailable under the recorded licenses. Line counts and the GitHub link remain available.

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Local scripts

First observation → 8b675599125d

No earlier version was observed for comparison.

Compare on GitHub

skills/okf-knowledge-format/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

8b675599125d → 8b675599125d

Diff text is unavailable under the recorded licenses. Line counts and the GitHub link remain available.

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 8b675599125d

No earlier version was observed for comparison.

Compare on GitHub

skills/research-artifacts/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Instructions only → After Instructions only

8b675599125d → 8b675599125d

Diff text is unavailable under the recorded licenses. Line counts and the GitHub link remain available.

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Instructions only

First observation → 8b675599125d

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 8b675599125d4d7e07fbd4f50956c1a003019d60

git clone --filter=blob:none --no-checkout https://github.com/ejklock/living-docs-skill.git .hotskills/ejklock-living-docs-skill && git -C .hotskills/ejklock-living-docs-skill checkout --detach 8b675599125d4d7e07fbd4f50956c1a003019d60 # Copy each selected skill directory from .hotskills/ejklock-living-docs-skill into .claude/skills/<skill-name>/
14GitHub stars
0stars in 7 days
3skills in this repository
66commits in 30 days

Heat

1.7
  • Star growth, last 7 daysNot available
  • Star growth, last 24 hoursNot available
  • Rank movement, last 7 daysNot available
  • Commits, last 30 daysNot available
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Oct 25, 2026Nov 4, 202614

30-day change not yet available: not enough history.

Individual skills in this repository

How it works

living-docs

When your agent uses it

Run a project's engineering decisions as a living log — MADR-lite ADRs (supersede, never delete) for decisions expensive to reverse, issues for the work (and its cheap-to-reverse choices), research artifacts, an optional PRD, a project constitution, and living Mermaid architecture views, where every record has exactly one home, indexes never drift, and a record is earned by materiality, not written per layer. Use when setting up or maintaining project docs, writing an ADR/PRD/constitution/issue/research note, drawing or updating an architecture diagram, or enforcing the no-drift maintenance rule.

What it loads into context

Frontmatter

173 tokens

Always available to the agent

SKILL.md

1,476 tokens

When the skill is activated

Reference documents

20,607 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Using this skill (progressive disclosure)
  2. The one rule that decides whether to write a record
  3. When to invoke

Scripts executed separately

  • hooks/pre-commit
  • hooks/session-context.sh
  • tests/run.sh

Files

  • SKILL.mdcore6,283 bytes
  • SKILL.mdcore6,283 bytes
  • hooks/pre-commitruns1,098 bytes
  • hooks/session-context.shruns1,962 bytes
  • rules/adr-conventions.mddoc7,451 bytes
  • rules/architecture-diagrams.mddoc7,615 bytes
  • rules/check.mddoc4,692 bytes
  • rules/constitution-conventions.mddoc3,576 bytes
  • rules/doc-trail.mddoc3,975 bytes
  • rules/issue-workflow.mddoc4,053 bytes
  • rules/okf-format.mddoc2,364 bytes
  • rules/prd-conventions.mddoc3,877 bytes
  • rules/procedure.mddoc8,445 bytes
  • rules/semantic-index.mddoc5,261 bytes
  • rules/size-targets.mddoc1,492 bytes
  • rules/spine.mddoc1,446 bytes
  • templates/adr.mddoc1,129 bytes
  • templates/architecture-view.mddoc495 bytes
  • templates/claude-hard-rules.mddoc8,565 bytes
  • templates/constitution.mddoc1,178 bytes
  • templates/context-index.mddoc921 bytes
  • templates/issue.mddoc757 bytes
  • templates/prd.mddoc1,101 bytes
  • templates/research.mddoc952 bytes
  • tests/fixtures/01-fence-link-clean/docs/foo.mddoc144 bytes
  • tests/fixtures/01-fence-link-clean/docs/index.mddoc27 bytes
  • tests/fixtures/02-fence-link-dirty/docs/foo.mddoc62 bytes
  • tests/fixtures/02-fence-link-dirty/docs/index.mddoc27 bytes
  • tests/fixtures/03-link-forms/docs/bar.mddoc58 bytes
  • tests/fixtures/03-link-forms/docs/foo.mddoc145 bytes
  • tests/fixtures/03-link-forms/docs/index.mddoc45 bytes
  • tests/fixtures/04-frontmatter-quoted-commented/docs/a.mddoc78 bytes
  • tests/fixtures/04-frontmatter-quoted-commented/docs/b.mddoc78 bytes
  • tests/fixtures/04-frontmatter-quoted-commented/docs/c.mddoc96 bytes
  • tests/fixtures/04-frontmatter-quoted-commented/docs/index.mddoc51 bytes
  • tests/fixtures/05-nested-key-trap/docs/foo.mddoc38 bytes
  • tests/fixtures/05-nested-key-trap/docs/index.mddoc27 bytes
  • tests/fixtures/06-block-scalar-ok/docs/foo.mddoc82 bytes
  • tests/fixtures/06-block-scalar-ok/docs/index.mddoc27 bytes
  • tests/fixtures/07-supersede-broken/docs/0001-old.mddoc65 bytes
  • tests/fixtures/07-supersede-broken/docs/index.mddoc32 bytes
  • tests/fixtures/08-reference-link-broken/docs/foo.mddoc75 bytes
  • tests/fixtures/08-reference-link-broken/docs/index.mddoc27 bytes
  • tests/fixtures/09-okf-canonical/PROVENANCE.mddoc1,464 bytes
  • tests/fixtures/09-okf-canonical/docs/datasets/crypto_bitcoin.mddoc2,090 bytes
  • tests/fixtures/09-okf-canonical/docs/datasets/index.mddoc181 bytes
  • tests/fixtures/09-okf-canonical/docs/index.mddoc297 bytes
  • tests/fixtures/09-okf-canonical/docs/tables/blocks.mddoc728 bytes
  • tests/fixtures/09-okf-canonical/docs/tables/index.mddoc434 bytes
  • tests/fixtures/09-okf-canonical/docs/tables/inputs.mddoc2,196 bytes
  • tests/fixtures/09-okf-canonical/docs/tables/outputs.mddoc2,270 bytes
  • tests/fixtures/09-okf-canonical/docs/tables/transactions.mddoc5,649 bytes
  • tests/fixtures/10-mermaid-valid/doc.mddoc287 bytes
  • tests/fixtures/11-mermaid-invalid/doc.mddoc141 bytes
  • tests/run.shruns3,826 bytes

No excerpt is shown for this license. Read the source on GitHub.

View the complete source on GitHub

Skills included

  • living-docs
  • okf-knowledge-format
  • research-artifacts

Repository facts

License
No license detected
Created
Jun 19, 2026
Last pushed
Oct 27, 2026
Forks
3
Open issues
0
Project activity
Active

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 5, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 5 notes
  • skills/living-docs/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/research-artifacts/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/research-artifacts/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/research-artifacts/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/research-artifacts/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
Show all 72 signals by file

references/prior-art-landscape.md

  • Network accessline 57
    ADZIC, Gojko. **Specification by Example**: how successful teams deliver the right software. Shelter Island: Manning, 2011. Available at: https://gojko.net/books/specification-by-example/. Accessed on: 2026-06-15.
  • Network accessline 59
    BMAD-CODE-ORG. **BMAD-METHOD**: Breakthrough Method for Agile AI-Driven Development. 2025. Available at: https://github.com/bmad-code-org/BMAD-METHOD. Accessed on: 2026-06-15.
  • Network accessline 61
    BROWN, Simon. **The C4 model for visualising software architecture**. Available at: https://c4model.com/. Accessed on: 2026-06-15.
  • Network accessline 63
    BUILDER METHODS. **Agent OS**. 2025. Available at: https://github.com/buildermethods/agent-os. Accessed on: 2026-06-15.
  • Network accessline 65
    GITHUB. **Spec Kit**: spec-driven development toolkit. 2025. Available at: https://github.com/github/spec-kit. Accessed on: 2026-06-15.
  • Network accessline 67
    GOOGLE CLOUD PLATFORM. **Open Knowledge Format — Specification v0.1 (Draft)**. 2026. Available at: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md. Accessed on: 2026-06-15.
  • Network accessline 71
    NORTH, Dan. **Introducing BDD**. 2006. Available at: https://dannorth.net/introducing-bdd/. Accessed on: 2026-06-15.
  • Network accessline 73
    NYGARD, Michael. **Documenting Architecture Decisions**. 2011. Available at: https://www.cognitect.com/blog/2011/11/15/documenting-architecture-decisions. Accessed on: 2026-06-15.
  • Network accessline 75
    PROCIDA, Daniele. **Diátaxis**: a systematic framework for technical documentation authoring. Available at: https://diataxis.fr/. Accessed on: 2026-06-15.
  • Network accessline 77
    PRYCE, Nat. **adr-tools**: command-line tools for working with Architecture Decision Records. Available at: https://github.com/npryce/adr-tools. Accessed on: 2026-06-15.
  • Network accessline 79
    SHOBSON, Will. **agents**: a marketplace of subagents, skills, and commands for AI coding harnesses. 2025. Available at: https://github.com/wshobson/agents. Accessed on: 2026-06-15.
  • Network accessline 81
    STARKE, Gernot; HRUSCHKA, Peter. **arc42**: template for architecture communication and documentation. Available at: https://arc42.org/. Accessed on: 2026-06-15.
  • Network accessline 83
    SVEIDQVIST, Knut. **Mermaid**: generation of diagrams and flowcharts from text in a similar manner as Markdown. Available at: https://mermaid.js.org/. Accessed on: 2026-06-15.
  • Network accessline 85
    ZANZAL, Owen. **Behavior Decision Records**: specifying what a system must do before deciding how to build it. Medium (DevOps<>AI), 2026. Available at: https://medium.com/devops-ai/behavior-decision-records-specifying-what-a-system-must-do-

skills/living-docs/hooks/pre-commit

  • Executable scriptline 1
    #!/usr/bin/env bash

skills/living-docs/hooks/session-context.sh

  • Executable scriptline 1
    #!/usr/bin/env bash

skills/living-docs/tests/fixtures/09-okf-canonical/docs/datasets/crypto_bitcoin.md

  • Network accessline 4
    description: This BigQuery public dataset contains a complete history of the Bitcoin blockchain and updates every 10 minutes. tags: [bitcoin, blockchain, cryptocurrency, data-analytics, gcp, public data] resource: https://bigquery.googleapi
  • Network accessline 5
    tags: [bitcoin, blockchain, cryptocurrency, data-analytics, gcp, public data] resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin timestamp: 2026-05-28T22:44:47+00:00
  • Network accessline 6
    resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin
  • Network accessline 47
    [1] [BigQuery Public Dataset: crypto_bitcoin](https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin)
  • Network accessline 48
    [2] [Bitcoin in BigQuery: blockchain analytics on public data](https://cloud.google.com/blog/products/gcp/bitcoin-in-bigquery-blockchain-analytics-on-public-data)

skills/living-docs/tests/fixtures/09-okf-canonical/docs/tables/blocks.md

  • Network accessline 4
    description: Details about the Bitcoin Blocks BigQuery table, including its schema. tags: [bigquery, bitcoin, blockchain, blocks] resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/bloc
  • Network accessline 5
    tags: [bigquery, bitcoin, blockchain, blocks] resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/blocks timestamp: 2026-05-28T22:43:59+00:00
  • Network accessline 6
    resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/blocks
  • Network accessline 27
    # Citations - https://github.com/blockchain-etl/bitcoin-etl
  • Network accessline 28
    - https://github.com/blockchain-etl/bitcoin-etl

skills/living-docs/tests/fixtures/09-okf-canonical/docs/tables/inputs.md

  • Network accessline 4
    description: Details about transaction inputs on the Bitcoin blockchain. tags: [bitcoin, blockchain, cryptocurrency, etl, inputs, transactions] resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitco
  • Network accessline 5
    tags: [bitcoin, blockchain, cryptocurrency, etl, inputs, transactions] resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/inputs timestamp: 2026-05-28T22:44:24+00:00
  • Network accessline 6
    resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/inputs
  • Network accessline 58
    [1] [BigQuery Table: inputs](https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/inputs)
  • Network accessline 59
    [2] [blockchain-etl/bitcoin-etl](https://github.com/blockchain-etl/bitcoin-etl)

skills/living-docs/tests/fixtures/09-okf-canonical/docs/tables/outputs.md

  • Network accessline 4
    description: Outputs from all transactions in the Bitcoin blockchain. tags: [bitcoin, blockchain, etl, outputs, transactions] resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/outputs
  • Network accessline 5
    tags: [bitcoin, blockchain, etl, outputs, transactions] resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/outputs timestamp: 2026-05-28T22:44:32+00:00
  • Network accessline 6
    resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/outputs
  • Network accessline 62
    [1] [Outputs Table](https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/outputs)
  • Network accessline 63
    [2] [Bitcoin ETL on GitHub](https://github.com/blockchain-etl/bitcoin-etl)

skills/living-docs/tests/fixtures/09-okf-canonical/docs/tables/transactions.md

  • Network accessline 4
    description: A comprehensive table detailing all transactions on the Bitcoin blockchain. tags: [bitcoin, blockchain, crypto, etl, public data, transactions] resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets
  • Network accessline 5
    tags: [bitcoin, blockchain, crypto, etl, public data, transactions] resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/transactions timestamp: 2026-05-28T22:45:04+00:00
  • Network accessline 6
    resource: https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/transactions
  • Network accessline 103
    # Citations [1] [Bitcoin Transactions](https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/transactions)
  • Network accessline 104
    [1] [Bitcoin Transactions](https://bigquery.googleapis.com/v2/projects/bigquery-public-data/datasets/crypto_bitcoin/tables/transactions)
  • Network accessline 105
    [2] [Bitcoin ETL](https://github.com/blockchain-etl/bitcoin-etl)
  • Network accessline 106
    [3] [Bitcoin in BigQuery: blockchain analytics on public data](https://cloud.google.com/blog/products/gcp/bitcoin-in-bigquery-blockchain-analytics-on-public-data)

skills/living-docs/tests/run.sh

  • Executable scriptline 1
    #!/usr/bin/env bash

skills/okf-knowledge-format/reference/SPEC.md

  • Network accessline 184
    title: Customer Orders description: One row per completed customer order across all channels. resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders
  • Network accessline 185
    description: One row per completed customer order across all channels. resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders tags: [sales, orders, revenue]
  • Network accessline 186
    resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders
  • Network accessline 206
    [1] [BigQuery table schema](https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders)
  • Network accessline 227
    1. Check the [ingestion job dashboard](https://example.com/dash).
  • Network accessline 331
    [1] [BigQuery public dataset announcement](https://cloud.google.com/blog/products/data-analytics/...)
  • Network accessline 332
    [2] [Internal data quality runbook](https://wiki.acme.internal/data/quality)
  • Network accessline 419
    title: Sales description: All sales-related tables for the retail business. resource: https://console.cloud.google.com/bigquery?p=acme&d=sales
  • Network accessline 420
    description: All sales-related tables for the retail business. resource: https://console.cloud.google.com/bigquery?p=acme&d=sales tags: [sales]
  • Network accessline 421
    resource: https://console.cloud.google.com/bigquery?p=acme&d=sales
  • Network accessline 435
    title: Orders description: One row per completed customer order. resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders
  • Network accessline 436
    description: One row per completed customer order. resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders tags: [sales, orders]
  • Network accessline 437
    resource: https://console.cloud.google.com/bigquery?p=acme&d=sales&t=orders

skills/okf-knowledge-format/reference/SPEC.source.md

  • Network accessline 10
    | Source path | `okf/SPEC.md` | | Ref | `main` | | Raw URL | https://raw.githubusercontent.com/GoogleCloudPlatform/knowledge-catalog/main/okf/SPEC.md |
  • Network accessline 11
    | Ref | `main` | | Raw URL | https://raw.githubusercontent.com/GoogleCloudPlatform/knowledge-catalog/main/okf/SPEC.md | | Retrieved | 2026-06-13T08:21:50Z |
  • Network accessline 12
    | Raw URL | https://raw.githubusercontent.com/GoogleCloudPlatform/knowledge-catalog/main/okf/SPEC.md |

skills/okf-knowledge-format/scripts/update-spec.sh

  • Executable scriptline 1
    #!/usr/bin/env bash
  • Network accessline 25
    OKF_PATH="okf/SPEC.md" OKF_REF="${1:-main}" OKF_RAW_URL="${OKF_RAW_URL:-https://raw.githubusercontent.com/${OKF_REPO}/${OKF_REF}/${OKF_PATH}}"
  • Network accessline 27
    OKF_RAW_URL="${OKF_RAW_URL:-https://raw.githubusercontent.com/${OKF_REPO}/${OKF_REF}/${OKF_PATH}}"
  • Dangerous shell operationline 35
    trap 'rm -f "$tmp"' EXIT
  • Network accessline 38
    echo "  repo: $OKF_REPO" echo "  ref:  $OKF_REF" echo "  url:  $OKF_RAW_URL"
  • Network accessline 40
    echo "  url:  $OKF_RAW_URL"
  • Network accessline 42
    if ! curl -fsSL "$OKF_RAW_URL" -o "$tmp"; then
  • Network accessline 43
    echo "ERROR: failed to fetch $OKF_RAW_URL" >&2
  • Network accessline 69
    | Source path | \`${OKF_PATH}\` | | Ref | \`${OKF_REF}\` | | Raw URL | ${OKF_RAW_URL} |
  • Network accessline 70
    | Ref | \`${OKF_REF}\` | | Raw URL | ${OKF_RAW_URL} | | Retrieved | $(date -u +%Y-%m-%dT%H:%M:%SZ) |
  • Network accessline 71
    | Raw URL | ${OKF_RAW_URL} |

skills/okf-knowledge-format/templates/concept.md

  • Network accessline 24
    [1] [External source backing a claim](https://example.com)

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Declared and executed: 1 fact
Signal confidence: 72 facts

and 22 more

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeNativePath .claude/settings.json.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md skills/living-docs/SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md skills/living-docs/SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md skills/living-docs/SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md skills/living-docs/SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md skills/living-docs/SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.