Agent skill

Conventions Check

by polarsource in polarsource/polar

Check a diff against Polar's written conventions in server/AGENTS.md and clients/AGENTS.md — module structure, repository and service patterns, session types, auth dependencies, test organisation…

MITAuto-check passedData & Analytics

Install Conventions Check

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

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

GitHub CLI
$ gh skill install polarsource/polar conventions-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/conventions-check .claude/skills/conventions-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
conventions-check
GitHub stars
10k
Token cost
~476 tokens
SKILL.md length
173 words
Files
1
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

Check a diff against Polar's written conventions in server/AGENTS.md and clients/AGENTS.md — module structure, repository and service patterns, session types, auth dependencies, test organisation…

  • Asks whether a change follows Polars conventions
  • SKILL.md covers Rule, Owned elsewhere and Output
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve DataFrames

What it does

Conventions Check is an agent skill from polarsource/polar. Check a diff against Polar's written conventions in server/AGENTS.md and clients/AGENTS.md — module structure, repository and service patterns, session types, auth dependencies, test organisation, Orbit Box usage, i18n placement. Use before opening a PR or when the user asks whether a change follows Polar's conventions.

Its SKILL.md is about 480 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 Data & Analytics, covering DataFrames, Internationalization and Agent instruction files. The repository describes itself as: Polar — A billing platform for the intelligence era. The licence is MIT.

When your agent uses it

  • Asks whether a change follows Polars conventions
  • Tasks that involve DataFrames
  • Tasks that involve Internationalization

Example prompts

  • “/conventions-check”

What it can do on your machine

Read from SKILL.md and the folder at commit e4fc909. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Conventions Check loads about 476 tokens when it runs. Until then it costs about 85 tokens; SKILL.md has 173 words of instructions outside code blocks.

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

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 e4fc909, republished under its MIT licence (© polarsource). 173 words, ~476 tokens.

Download SKILL.mdSave it as .claude/skills/conventions-check/SKILL.md (or your agent's skills folder).
name
conventions-check
description
Check a diff against Polar's written conventions in server/AGENTS.md and clients/AGENTS.md — module structure, repository and service patterns, session types, auth dependencies, test organisation, Orbit Box usage, i18n placement. Use before opening a PR or when the user asks whether a change follows Polar's conventions.
license
MIT
metadata.author
polar
metadata.version
1.0.0

Conventions Check (Polar)

The handle is the diff. The evidence is a list of places it breaks a rule written in AGENTS.md.

Rule

server/AGENTS.md and clients/AGENTS.md are the source of truth. Read them in full before reviewing. Do not work from memory, and do not invent a rule that is not in those files. If you want to flag something they do not cover, put it under Question.

Owned elsewhere

Do not report these; another lens covers them, and duplicate findings are what makes a review tiring to read.

TopicOwner
Anything an Accepted ADR coversadr-check
Reinventing an existing helperreuse-check
Agent-generated noise, redundant testsslop-check
API contract, schemas, SDK impactapi-surface-review
Migrations, tasks, deploy orderingship-safety
Billing domain behaviourbilling-review

What is left for you: module structure, the repository and service patterns, read versus write sessions, auth dependencies and per-module auth.py, test layout and fixtures, Orbit <Box /> usage, the 250-line frontend file limit, i18n placement.

Output

## Conventions

### 🔴 Blocking
- `file:line` — <claim>. Fix: <fix>

### 🟠 Should fix
- `file:line` — <claim>. Fix: <fix>

### 🟡 Question
- `file:line` — <question>

### Verdict
✅ Clean  |  ❌ n blocking, n should-fix

Quote the rule from AGENTS.md in the claim. High-confidence findings only. Never flag unchanged code.

© 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/conventions-check of polarsource/polar.

Open the folder on GitHubat commit e4fc909

Compare with similar skills

Conventions 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.

Conventions Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Conventions Check this skillpolarsource/polar10k—~476Automated safety check: PassMIT
Apify Actor Developmentsickn33/agentic-awesome-skills47k2 repos~3.3kAutomated safety check: PassMIT
Downloading Batch Export FilesPostHog/posthog40k—~2.4kAutomated safety check: PassCustom licence
Project InitializerDrchronx/ai-agent-research-starter-kit135—~406Automated safety check: PassCustom licence
Chdb Datastorevemetric/vemetric3942 repos~1.4kAutomated safety check: PassApache-2.0
CSV Data Summarizercoffeefuelbump/csv-data-summarizer-claude-skill4682 repos~1.4kAutomated safety check: PassNone

Similar skills

  • Apify Actor Development

    sickn33/agentic-awesome-skills

    Important: Before you begin, fill in the generatedBy property in the meta section of .actor/actor.json.

    47k GitHub starsUsed in 2 repos~3.3k tokens
    Data & AnalyticsAuto-check passed
  • Official

    Export PostHog events, persons, sessions, or the results of a HogQL query on demand and download the resulting files.

    40k GitHub stars~2.4k tokensUpdated today
    Data & AnalyticsAuto-check passed
  • Project Initializer

    Drchronx/ai-agent-research-starter-kit

    Initialize a structured academic research project workspace.

    135 GitHub stars~406 tokensUpdated 4 mo ago
    Data & AnalyticsAuto-check passed
  • Chdb Datastore

    vemetric/vemetric

    A skill your agent uses when the user has tabular data (pandas DataFrame, parquet, csv, Arrow, json) and wants to filter, group, aggregate, join, or speed up slow pandas.

    394 GitHub starsUsed in 2 repos~1.4k tokens
    Data & AnalyticsAuto-check passed
  • CSV Data Summarizer

    coffeefuelbump/csv-data-summarizer-claude-skill

    Analyzes CSV files, generates summary stats, and plots quick visualizations using Python and pandas.

    468 GitHub starsUsed in 2 repos~1.4k tokens
    Data & AnalyticsAuto-check passed
  • Ktx

    Kaelio/ktx

    Installs and configures ktx, the open-source context layer for data agents — runs ktx setup non-interactively with hidden CLI flags, configures database connections and embeddings, installs agent…

    1.6k GitHub starsUsed in 1 repo~3.2k tokens
    AI & LLM EngineeringAuto-check passed

More from polarsource/polar

All 18 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
  • Adr Check

    polarsource/polar

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

    10k GitHub stars~771 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

Questions about Conventions Check

What does Conventions Check do?

Check a diff against Polar's written conventions in server/AGENTS.md and clients/AGENTS.md — module structure, repository and service patterns, session types, auth dependencies, test organisation…. Conventions Check is an agent skill from polarsource/polar.md — module structure, repository and service patterns, session types, auth dependencies, test organisation, Orbit Box usage, i18n placement.

When should I use Conventions Check?

Conventions Check fits situations like: asks whether a change follows Polars conventions; tasks that involve DataFrames; tasks that involve Internationalization.

How do I install Conventions Check in Claude Code?

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

How do I install Conventions Check in Codex?

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

Can I use Conventions 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 conventions-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/conventions-check, .gemini/skills/conventions-check, .github/skills/conventions-check and .opencode/skills/conventions-check in your project.

What does Conventions Check need to run?

SKILL.md names no scripts, command-line tools or credentials: Conventions Check is instructions for the agent only.

Does Conventions Check access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Conventions 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 Conventions Check use?

Conventions 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 Conventions Check use?

About 476 tokens (SKILL.md is roughly 1.9k 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 Conventions Check?

Skills that share tags, products or a category with Conventions Check: Apify Actor Development (sickn33/agentic-awesome-skills, 47k stars), Downloading Batch Export Files (PostHog/posthog, 40k stars), Project Initializer (Drchronx/ai-agent-research-starter-kit, 135 stars) and Chdb Datastore (vemetric/vemetric, 394 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Conventions Check?

polarsource (a GitHub organization) maintains it in polarsource/polar, which has 10,340 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on October 7, 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.