docs-optimise SKILL.md skillA

docs-optimise from edmonds-commerce-limited/claude-code-hooks-daemon is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add edmonds-commerce-limited/claude-code-hooks-daemon/docs-optimise@git:20261018.99a457f

Pins git:20261018.99a457f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
edmonds-commerce-limited/claude-code-hooks-daemon
Path
src/claude_code_hooks_daemon/skills/docs-optimise/SKILL.md
Versions recorded
2
Latest version
git:20261018.99a457f, committed Oct 18, 2026
First version recorded
Oct 18, 2026
Size
2,181 bytes
Repository stars
4
License
MIT

Propose a restructure of this project's agent instruction files (CLAUDE.md, @-imports, .claude/rules/, nested CLAUDE.md) so less loads at session start — one canonical home per fact, progressive disclosure. Proposal only, never edits tracked files. Trigger on "optimise CLAUDE.md", "my CLAUDE.md is too big", "shrink the always-loaded context", "restructure the instruction files".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Documentation Optimise

This skill is a **shim**. The classification rules, the report layout and the
output paths are in [references/procedure.md](references/procedure.md); the
rules it applies are cited, not restated:

- how Claude Code loads instruction files: `contracts/claude-code-instructions/`
  in the daemon checkout (`META.json` names the audited Claude Code version)
- the daemon's documentation ruleset (R6, R7a, R7d):
  `CLAUDE/DocumentationStrategy.md`

## What to do

1. Measure first: run `.claude/skills/docs-optimise/scripts/footprint.sh`
   (it wraps `docs-qa --footprint --json`). It lists what loads at session
   start versus on demand, with line and byte totals.
2. Follow [references/procedure.md](references/procedure.md) to classify each
   always-loaded section and write the proposal.
3. Tell the user where the proposal is and how to apply the patch.

```claude-code
/docs-optimise                 # the whole instruction-file set
/docs-optimise CLAUDE.md       # focus on one file
```

## Contract

- **Proposal only.** Everything is written under
  `untracked/scratch/docs-optimise/<run-id>/`. It never edits a tracked file
  and never adds an allowlist entry.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add edmonds-commerce-limited/claude-code-hooks-daemon/docs-optimise@sha256:13a864f74a245688

The line at the top of this page pins the label git:20261018.99a457f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_2qja2vfcoxpib5zj.svg)](https://markdownregistry.com/a/art_2qja2vfcoxpib5zj)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Oct 18, 2026.

versioncommittedcommitsizeaudit
git:20261018.99a457f latest2026-10-18 99a457f 2,181 BA view · diff
git:20261018.128191b2026-10-18 128191b 2,124 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2181 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

edmonds-commerce-limited/claude-code-hooks-daemon · 4 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_2qja2vfcoxpib5zj
GET https://markdownregistry.com/api/v1/resolve?ref=edmonds-commerce-limited/claude-code-hooks-daemon/docs-optimise
GET https://markdownregistry.com/api/v1/blob/13a864f74a2456884e7a8b47a8e8e249274d0db70f4aef6f8623ea40b75ae11b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from edmonds-commerce-limited/claude-code-hooks-daemon

CLAUDE.md@.claude/agents CLAUDE.md file
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/agents/CLAUDE.md
git:20260828.d21a313 · audit A · 4 stars
CLAUDE.md@.claude/skills CLAUDE.md file
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/skills/CLAUDE.md
git:20260828.8e0b77e · audit A · 4 stars
acceptance-test SKILL.md skill
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/skills/acceptance-test/SKILL.md · Acceptance testing - execute handler tests via real Claude Code tool calls in main thread
git:20261013.289d231 · audit A · 4 stars
configure SKILL.md skill
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/skills/configure/SKILL.md · View and modify hooks daemon handler configuration - enable/disable handlers, change priorities, set handler options
git:20260902.20a7e8a · audit A · 4 stars
docs-optimise SKILL.md skill
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/skills/docs-optimise/SKILL.md · Propose a restructure of this project's agent instruction files (CLAUDE.md, @-imports, .claude/rules/, nested…
git:20261018.99a457f · audit A · 4 stars
docs-qa SKILL.md skill
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/skills/docs-qa/SKILL.md · Audit this project's documentation for SSoT violations — conflicting truths, duplicated facts, stale pointers, and…
git:20260907.788ce6c · audit A · 4 stars
hooks-daemon SKILL.md skill
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/skills/hooks-daemon/SKILL.md · Manage Claude Code Hooks Daemon - install, provision a fresh checkout, upgrade, optimise the configuration, check…
git:20261012.1079d06 · audit A · 4 stars
issue-sdlc SKILL.md skill
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/skills/issue-sdlc/SKILL.md · Take ONE open GitHub issue through the full delivery lifecycle — triage, plan, implement in a worktree, QA, review…
git:20261014.427d732 · audit A · 4 stars
mode SKILL.md skill
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/skills/mode/SKILL.md · Get or set daemon operating mode - switch between default and unattended (blocks Stop events)
git:20260902.20a7e8a · audit A · 4 stars
release SKILL.md skill
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/skills/release/SKILL.md · Automated release management - version updates, changelog generation, git tagging, and GitHub release creation
git:20260930.d6e5fa2 · audit A · 4 stars
CLAUDE.md CLAUDE.md file
edmonds-commerce-limited/claude-code-hooks-daemon · CLAUDE.md
git:20261016.4674f18 · audit B · 4 stars
CLAUDE.md@CLAUDE CLAUDE.md file
edmonds-commerce-limited/claude-code-hooks-daemon · CLAUDE/CLAUDE.md
git:20260924.64c63b3 · audit A · 4 stars

Every file in edmonds-commerce-limited/claude-code-hooks-daemon

Other files named docs-optimise

docs-optimise SKILL.md skill
edmonds-commerce-limited/claude-code-hooks-daemon · .claude/skills/docs-optimise/SKILL.md · Propose a restructure of this project's agent instruction files (CLAUDE.md, @-imports, .claude/rules/, nested…
git:20261018.99a457f · audit A · 4 stars

Browse by kind, by grade A, or by owner.