New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Adr Check

by polarsource in polarsource/polar

Check a code change against the repo's Accepted Architecture Decision Records (ADRs) in handbook/engineering/decisions/ and report violations with citations.

MITAuto-check passedDevelopment

Install Adr Check

skills CLI
$ npx skills add polarsource/polar --skill adr-check -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install polarsource/polar adr-check --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/polarsource/polar.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/adr-check .claude/skills/adr-check && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
adr-check
GitHub stars
10k
Token cost
~771 tokens
SKILL.md length
381 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Check a code change against the repo's Accepted Architecture Decision Records (ADRs) in handbook/engineering/decisions/ and report violations with citations.

  • Works in 4 steps: Get the change → Load the ADRs (dynamically, never… → Check each relevant ADR against the diff → …
  • Asks to check ADR compliance
  • SKILL.md covers When to use and How to run
  • Calls git

What it does

Adr Check is an agent skill from polarsource/polar. Check a code change against the repo's Accepted Architecture Decision Records (ADRs) in handbook/engineering/decisions/ and report violations with citations. Use before opening a PR, when reviewing a diff, or when the user asks to check ADR compliance, whether changes follow the architecture decisions, or to verify a change against the ADRs.

Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Architecture decision records. The repository describes itself as: Polar — A billing platform for the intelligence era. The licence is MIT.

When your agent uses it

  • Asks to check ADR compliance
  • Whether changes follow the architecture decisions
  • Verify a change against the ADRs

Example prompts

  • “/adr-check”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Get the change
  2. Load the ADRs (dynamically, never hardcode the list)
  3. Check each relevant ADR against the diff
  4. Report

What it can do on your machine

Read from SKILL.md and the folder at commit 71c1ac6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Adr Check loads about 771 tokens when it runs. Until then it costs about 88 tokens; SKILL.md has 381 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~88
When it runs · the whole SKILL.md, loaded when a task matches
~771

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from polarsource/polar at commit 71c1ac6, republished under its MIT licence (© polarsource). 381 words, ~771 tokens.

Download SKILL.mdSave it as .claude/skills/adr-check/SKILL.md (or your agent's skills folder).
name
adr-check
description
Check a code change against the repo's Accepted Architecture Decision Records (ADRs) in handbook/engineering/decisions/ and report violations with citations. Use before opening a PR, when reviewing a diff, or when the user asks to check ADR compliance, whether changes follow the architecture decisions, or to verify a change against the ADRs.
license
MIT
metadata.author
polar
metadata.version
1.0.0

ADR Compliance Checker (Polar)

The handle is the diff. The evidence is a short report of which Accepted ADRs the change touches and where it breaks them. This is the ADR analogue of verifier-web: that skill replays UI changes, this one reviews a change against the recorded architecture decisions.

ADRs live in handbook/engineering/decisions/. Treat every ADR whose Status is Accepted as binding.

When to use

  • Before opening a PR, or while reviewing one.
  • When the user asks to "check the ADRs", "does this follow our decisions", or "verify against the architecture decisions".
  • As one dimension of a broader review, alongside /polar-code-review.

How to run

1. Get the change

Prefer the branch diff; fall back to the working tree.

bash
git diff --name-only main...HEAD    # committed on this branch
git diff --name-only                # unstaged
git diff --name-only --staged       # staged

This assumes the branch targets main (the default). If the PR targets another branch, diff against that base instead.

Then read the actual hunks for the changed files (git diff main...HEAD -- <file>).

2. Load the ADRs (dynamically, never hardcode the list)
bash
ls handbook/engineering/decisions/[0-9]*.mdx

Read each one. For every ADR with Status: Accepted, extract its Decision (the rule) and its Area (Backend, Frontend, Infra, or Cross-cutting). Apply an ADR only to files in its Area: a frontend ADR does not apply to server/, and vice versa. Reading the ADRs each run keeps the check current as ADRs are added, edited or superseded.

Show full SKILL.md (164 more words)Show less
3. Check each relevant ADR against the diff

For each Accepted ADR whose Area matches a changed file, read its Decision and Consequences and derive the violation signature from them: the Decision states the rule, and the Consequences often spell out the "must" and the failure it prevents. Then look for that signature in the changed hunks (grep for the concrete identifiers the ADR names, and read the surrounding code). Don't rely on a signature list kept here: it would drift from the ADRs. The ADR text is the source of truth.

4. Report

Be terse. Do not narrate which ADRs you checked, list applicable/not-applicable ADRs, or explain your process.

  • No violations: reply with exactly No violations and nothing else.
  • Violations found: list them most severe first. For each, reference the ADR (id and title) and the violation: the file:line, one line on what breaks the rule, and the fix.

This skill reviews and reports. It does not edit code; fixes are a follow-up.

© polarsource, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/adr-check of polarsource/polar.

Open the folder on GitHubat commit 71c1ac6

Compare with similar skills

Adr Check next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Adr Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Adr Check this skillpolarsource/polar10k—~771Automated safety check: PassMIT
PR Design DocOpenHands/OpenHands90k—~2.4kAutomated safety check: PassMIT
Cto AdvisorIbrahim-3d/orchestrator-supaconductor3814 repos~2.4kAutomated safety check: PassMIT
Architecture DecisionDonchitos/Claude-Code-Game-Studios26k—~1.7kAutomated safety check: PassMIT
Improve Codebase Architectureywwynm/EverythingDone14415 repos~1.3kAutomated safety check: PassGPL-3.0
Domain Modelingbrim-borium/spotify_sdk1665 repos~806Automated safety check: PassApache-2.0

Similar skills

  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    90k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed

  • Cto Advisor

    Ibrahim-3d/orchestrator-supaconductor

    Technical leadership guidance for engineering teams, architecture decisions, and technology strategy.

    381 GitHub starsUsed in 4 repos~2.4k tokens
    DevelopmentAuto-check passed

  • Architecture Decision

    Donchitos/Claude-Code-Game-Studios

    Create an ADR documenting a technical decision: context, alternatives considered, consequences.

    26k GitHub stars~1.7k tokensUpdated yesterday
    DevelopmentAuto-check passed

  • Improve Codebase Architecture

    ywwynm/EverythingDone

    Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/.

    144 GitHub starsUsed in 15 repos~1.3k tokens
    DevelopmentAuto-check passed

  • Domain Modeling

    brim-borium/spotify_sdk

    Build and sharpen a project's domain model. An agent skill from brim-borium/spotify_sdk.

    166 GitHub starsUsed in 5 repos~806 tokens
    DevelopmentAuto-check passed

  • Design Doc Mermaid

    SpillwaveSolutions/design-doc-mermaid

    Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.

    176 GitHub starsUsed in 1 repo~5.6k tokens
    DevelopmentAuto-check passed

More from polarsource/polar

All 17 skills in this repo

  • Polar Python SDK

    polarsource/polar

    Integrate Polar billing in server-side Python applications using the versioned Polar and PolarAsync clients.

    10k GitHub stars~1.8k tokensUpdated today
    Auto-check passed

  • Polar Typescript SDK

    polarsource/polar

    Integrate Polar billing in server-side TypeScript applications using the versioned createPolar and createPolarCore clients.

    10k GitHub stars~2k tokensUpdated today
    Auto-check passed

  • API Surface Review

    polarsource/polar

    Review changes to Polar's API contract — Pydantic schemas, FastAPI endpoints, OpenAPI output and the generated SDKs.

    10k GitHub stars~1.3k tokensUpdated today
    Auto-check passed

  • Billing Review

    polarsource/polar

    Review a diff that touches Polar's billing domain — subscriptions, cycles and crons, orders, billing entries, meters and usage, discounts, checkout, payments and dunning, refunds, disputes, payouts…

    10k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

  • Interview Task

    polarsource/polar

    Prepare an interview task for a candidate, as part of our hiring process.

    10k GitHub stars~933 tokensUpdated today
    Auto-check passed

  • Open PR

    polarsource/polar

    Open or update a draft GitHub pull request after Polar-specific review and cubic CLI review.

    10k GitHub stars~586 tokensUpdated today
    Auto-check passed

Categories

Questions about Adr Check

What does Adr Check do?

Check a code change against the repo's Accepted Architecture Decision Records (ADRs) in handbook/engineering/decisions/ and report violations with citations. Adr Check is an agent skill from polarsource/polar. Check a code change against the repo's Accepted Architecture Decision Records (ADRs) in handbook/engineering/decisions/ and report violations with citations.

When should I use Adr Check?

Adr Check fits situations like: asks to check ADR compliance; whether changes follow the architecture decisions; verify a change against the ADRs.

How do I install Adr Check in Claude Code?

Run `npx skills add polarsource/polar --skill adr-check -a claude-code`. Or copy the skill folder (.agents/skills/adr-check in polarsource/polar) into .claude/skills/adr-check in your project. Claude Code loads it when a task matches its description.

How do I install Adr Check in Codex?

Run `npx skills add polarsource/polar --skill adr-check -a codex`. Or copy the skill folder (.agents/skills/adr-check in polarsource/polar) into .agents/skills/adr-check in your project. Codex loads it when a task matches its description.

Can I use Adr Check in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add polarsource/polar --skill adr-check -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/adr-check, .gemini/skills/adr-check, .github/skills/adr-check and .opencode/skills/adr-check in your project.

What does Adr Check need to run?

Going by SKILL.md and its folder, Adr Check needs the command-line tools its instructions call (git).

Does Adr Check access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Adr Check safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Adr Check use?

Adr Check is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Adr Check use?

About 771 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Adr Check?

Skills that share tags, products or a category with Adr Check: PR Design Doc (OpenHands/OpenHands, 90k stars), Cto Advisor (Ibrahim-3d/orchestrator-supaconductor, 381 stars), Architecture Decision (Donchitos/Claude-Code-Game-Studios, 26k stars) and Improve Codebase Architecture (ywwynm/EverythingDone, 144 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Adr Check?

polarsource (a GitHub organization) maintains it in polarsource/polar, which has 10,343 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 9, 2026.

Source: polarsource/polar on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.