Skip to content
Back to search

docrank

MarketplaceWorks with Claude CodeGitHub

docrank: the method enforced by hooks instead of asked for.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 19 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/nacorga/docrank with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/nacorga/docrank'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nacorga--docrank/badge.svg)](/listings/nacorga--docrank)

HTML

<a href="/listings/nacorga--docrank"><img src="/api/listings/nacorga--docrank/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/plugin marketplace add nacorga/docrank
/plugin install docrank@docrank

On Claude Code 2.1.275 or later, one step: `/plugin install docrank --marketplace nacorga/docrank`.

The install asks for a scope. User scope turns the principles and the default guards on in every repository on the machine; local or project scope keeps them to the repository you configure. Auto-update is off for a third-party marketplace: update with `claude plugin update docrank@docrank`, or turn auto-update on in the `/plugin` Marketplaces tab.

To try it from a checkout without installing: `claude --plugin-dir <path to this repository>`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines
  1. {
  2. "name": "docrank",
  3. "owner": { "name": "Ignacio Cortés" },
  4. "description": "docrank: the method enforced by hooks instead of asked for.",
  5. "plugins": [
  6. {
  7. "name": "docrank",
  8. "source": "./",
  9. "description": "Guard hooks, read-only judges, gates before a push and docs that outrank code."
  10. }
  11. ]
  12. }
README.md · README · 113 lines
  1. # docrank
  2. A Claude Code plugin that enforces a working method instead of asking for it.
  3. Guard hooks refuse what cannot be taken back; read-only judges review a change
  4. against the repository's documents; the repository's gates must pass before a
  5. push; documents outrank code when the two disagree; a short set of working
  6. principles starts every session. One file per repository,
  7. `.claude/docrank.json`, adapts all of it, and the `init` skill proposes that
  8. file by reading the repository.
  9. ## Install
  10. ```
  11. /plugin marketplace add nacorga/docrank
  12. /plugin install docrank@docrank
  13. ```
  14. On Claude Code 2.1.275 or later, one step: `/plugin install docrank --marketplace nacorga/docrank`.
  15. The install asks for a scope. User scope turns the principles and the default
  16. guards on in every repository on the machine; local or project scope keeps
  17. them to the repository you configure. Auto-update is off for a third-party
  18. marketplace: update with `claude plugin update docrank@docrank`, or turn
  19. auto-update on in the `/plugin` Marketplaces tab.
  20. To try it from a checkout without installing: `claude --plugin-dir <path to this repository>`.
  21. ## Quick start
  22. In the repository you want to guard, run `/docrank:init`. It reads the
  23. branches, the package manager, the scripts, the formatter and the docs tree,
  24. proposes a complete `.claude/docrank.json` with a reason for each key it sets,
  25. and writes nothing until you confirm. Without that file every guard runs on its
  26. defaults and the features that need a setting stay off.
  27. ## What each guard refuses
  28. Every key is documented once, with its default, in [docs/config.md](docs/config.md).
  29. | Guard | Refuses | Key |
  30. |---|---|---|
  31. | Bash | `git reset --hard`, `git clean -fd`, `git checkout .`, force pushes, `git push --no-verify`, `rm -rf` of a root, the current directory or home | always on |
  32. | Bash | a push naming a protected branch, a bare push or `git merge` while on one, `gh pr merge --admin`, a merge into a protected branch or a base not in the allowed list | `branches.*` |
  33. | Bash | a push of a commit whose gates have not passed | `gates.requireBeforePush`, `gates.run` |
  34. | Bash | pushing tags that match a pattern, `--tags`, `--follow-tags` | `guard.blockedTagPatterns` |
  35. | Bash | `npm publish`, `pnpm publish` | `guard.publishBan` |
  36. | Bash | moving the main checkout off the integration branch, deleting an unmerged branch | `branches.integration` |
  37. | Bash | any command that matches a pattern the repository adds | `guard.extraDeny` |
  38. | Bash | a write or a command that runs, from a read-only agent | `judges.skill` |
  39. | Agent | a fork dispatch; an Opus dispatch with no `Heavy:` line; completes a dispatch with the guardrails block, and sets the default model and effort | `dispatch.*` |
  40. | SendMessage | a message to a judge past its re-check limit, once | `judges.maxRechecks` |
  41. | Edit, Write | `.env*` except `.env.example`, lockfiles, and the repository's own rules | `paths.builtIns`, `paths.rules` |
  42. | ExitPlanMode | a plan without a required heading | `plan.requiredHeadings` |
  43. | `gh pr create` | the first one of a branch whose diff touches product or surface paths, once, with the handover checklist | `pr.*`, `surface.paths` |
  44. | MCP tools | the first send of a message through a configured tool, once, with a claims checklist | `messages.*` |
  45. Around them, not refusing: the formatter and linter run on each edited file
  46. (`format.*`), a question at the end of a session whose code changes a document
  47. did not follow (`docDrift.*`), a worktree cut from the fetched integration
  48. branch with the repository's ignored files copied in (`worktree.*`), the working
  49. principles at session start (`principles.*`), a hand-off request when the
  50. context grows past a threshold (`handoff.*`), and an optional link between
  51. Claude Code's memory and the repository's tracked `.claude/memory` (`memory.link`,
  52. experimental).
  53. An invalid `.claude/docrank.json` refuses every guarded call and names each
  54. problem. A guard stops accidents, not a determined attempt: every Bash
  55. refusal is also logged to `~/.claude/blocked-commands.log`.
  56. ## Skills, agents and the CLI
  57. Skills: `init` (propose the configuration), `gates` (run `gates.run` in order,
  58. PASS or FAIL each, and record the commit that passed), `ship` (one piece of
  59. work from worktree to a green pull request; the merge stays yours),
  60. `doc-lint` (sweep the documents for what no test catches),
  61. `judge-protocol` and `dispatch-guardrails` (loaded by agents and dispatches).
  62. Agents, both read-only: `spec-arbiter` (a diff against the documents by
  63. `docs.precedence`; labels each disagreement a code defect or a doc defect) and
  64. `surface-reviewer` (opens the rendered pages in a headless Chrome, which the
  65. plugin starts through `chrome-devtools-mcp`, at `surface.widths`).
  66. The CLI is `node <plugin>/bin/docrank.mjs <command>`:
  67. - `config` prints the resolved configuration, or each error and exit 1.
  68. - `check sections` and `check drift-pairs` hold the documents to their
  69. references and to a pair for every code unit (`docs.scanRoots`, `docs.unitRoots`).
  70. - `judges [<range>]` names the judges a diff needs (`judges.routes`).
  71. `templates/pre-push` is an optional git hook with the same gates check, for
  72. pushes made outside Claude Code; `init` offers it.
  73. ## Requirements
  74. Node 20 or later, git, and `gh` for the pull request features. macOS and Linux;
  75. Windows is not supported. The plugin has no run-time npm dependency, and the
  76. browser server of `surface-reviewer` needs `npx` and Chrome.
  77. ## What is proved live, and what is not
  78. Trial runs of the installed plugin in two real repositories proved the Bash
  79. guard, the gates and their record before a push, format and lint on edit, the
  80. session-start principles, a judge review and its re-check count, doc drift on
  81. `Stop`, `WorktreeCreate` and the browser server
  82. ([docs/harness-facts.md](docs/harness-facts.md) § 15). The plan, pull-request and
  83. message guards, the context hand-off and the judges' preloaded protocol ran
  84. live too. Not yet exercised live, though tested on stubbed input: the closing
  85. line rule, and the memory link, which is experimental: off by default, its
  86. directory rule undocumented by Claude Code.
  87. ## License
  88. MIT.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.