Agent skill

Citus Check Style Reindent

by citusdata in citusdata/citus

Fix a failing citusdata/citus check-style job by running make reindent with the exact uncrustify/citusindent versions the currently checked-out branch pins (read from its own STYLEGUIDE.md and its…

AGPL-3.0Auto-check: notesDatabases

Install Citus Check Style Reindent

skills CLI
$ npx skills add citusdata/citus --skill citus-check-style-reindent -a claude-code

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

GitHub CLI
$ gh skill install citusdata/citus citus-check-style-reindent --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/citusdata/citus.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/citus-check-style-reindent .claude/skills/citus-check-style-reindent && 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
citus-check-style-reindent
GitHub stars
13k
Token cost
~1.5k tokens
SKILL.md length
683 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Fix a failing citusdata/citus check-style job by running make reindent with the exact uncrustify/citusindent versions the currently checked-out branch pins (read from its own STYLEGUIDE.md and its…

  • Works in 4 steps: Read the pinned formatter versions from… → Build the exact formatter in a scratch… → Run make reindent → …
  • Check-style fails on whatever Citus branch is already checked out
  • SKILL.md covers 1. Read the pinned formatter…, 2. Build the exact formatter…, 3. Run make reindent and 4. Diff and commit
  • Calls git, make and curl; reaches github.com

What it does

Citus Check Style Reindent is an agent skill from citusdata/citus. Fix a failing citusdata/citus check-style job by running make reindent with the exact uncrustify/citusindent versions the currently checked-out branch pins (read from its own STYLEGUIDE.md and its own .github/workflows/buildandtest.yml), then inspect and commit the resulting style-only changes locally. USE WHEN check-style fails on whatever Citus branch is already checked out, or when asked to run make reindent safely. Works entirely on the current branch: it does not fetch, check out, or compare against any…

Its SKILL.md is about 1.5k 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 Databases, covering Linting and formatting. It works with GitHub Actions, PostgreSQL, SQL and Git. The repository describes itself as: Distributed PostgreSQL as an extension. The licence is AGPL-3.0.

When your agent uses it

  • Check-style fails on whatever Citus branch is already checked out
  • Asked to run make reindent safely

Example prompts

  • “/citus-check-style-reindent”

Workflow steps

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

  1. Read the pinned formatter versions from the current branch
  2. Build the exact formatter in a scratch location
  3. Run make reindent
  4. Diff and commit

What it can do on your machine

Read from SKILL.md and the folder at commit d41eec3. 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
    • make
    • curl
    • cmake
    • gh

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    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

Citus Check Style Reindent loads about 1.5k tokens when it runs. Until then it costs about 171 tokens; SKILL.md has 683 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:75
    sudo make install

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 citusdata/citus at commit d41eec3, republished under its AGPL-3.0 licence (© citusdata). 683 words, ~1,518 tokens.

Download SKILL.mdSave it as .claude/skills/citus-check-style-reindent/SKILL.md (or your agent's skills folder).
name
citus-check-style-reindent
description
Fix a failing citusdata/citus `check-style` job by running `make reindent` with the exact uncrustify/citus_indent versions the currently checked-out branch pins (read from its own `STYLEGUIDE.md` and its own `.github/workflows/build_and_test.yml`), then inspect and commit the resulting style-only changes locally. USE WHEN `check-style` fails on whatever Citus branch is already checked out, or when asked to run `make reindent` safely. Works entirely on the current branch: it does not fetch, check out, or compare against any other branch. This skill deliberately DOES NOT PUSH; it only commits locally. Push only if the caller separately tells you to.
license
See the repository LICENSE file.

Fix Citus check-style with the current branch's own formatter

check-style runs citus_indent (built on top of uncrustify) plus the smaller style tools called by ci/fix_style.sh. uncrustify changes formatting between releases, so a formatter version that is correct for main may rewrite many unrelated files on a release branch.

This skill assumes you are already on the branch you want to fix (checking out the right branch is the caller's job, not this skill's). Always use the formatter versions that this same checked-out branch pins — see step 1 for the two places they are recorded. Never use an arbitrary citus_indent or uncrustify already installed on the machine if its version does not match.

1. Read the pinned formatter versions from the current branch

check-style pins two versions and you need both: the uncrustify release, and the citusdata/tools release that citus_indent itself comes from. Read both out of the working copy you are already on — no git fetch, no git show, no gh api, no other branch involved.

a. The uncrustify version, from STYLEGUIDE.md:

bash
grep -A2 'Uncrustify changes the way' STYLEGUIDE.md

Find the line shaped like:

bash
curl -L https://github.com/uncrustify/uncrustify/archive/uncrustify-<VERSION>.tar.gz | tar xz

<VERSION> is the exact uncrustify version for this run. Follow any newer installation instructions in STYLEGUIDE.md if they differ from the example below.

b. The citusdata/tools version, from the workflow that runs check-style:

bash
grep style_checker_tools_version .github/workflows/build_and_test.yml

CI does not build citus_indent from the tools repo's moving default branch. It runs the ghcr.io/citusdata/stylechecker image built at that exact tools version, so citus_indent is pinned just like uncrustify is. A newer citus_indent can produce output that the pinned CI formatter still rejects, which looks like "I reindented and check-style is still red".

<TOOLS_VERSION> is the value of that key (for example 0.8.33). The matching git tag in citusdata/tools is that value prefixed with v, so v<TOOLS_VERSION> (for example v0.8.33).

2. Build the exact formatter in a scratch location

Use a throwaway directory. Do not overwrite or trust an existing formatter installation. The curl and the git clone here only download pinned third-party sources; neither is a lookup of another Citus branch.

bash
curl -L https://github.com/uncrustify/uncrustify/archive/uncrustify-<VERSION>.tar.gz | tar xz
cd uncrustify-uncrustify-<VERSION>
mkdir build
cd build
cmake ..
make -j"$(nproc)"
sudo make install
cd ../..

git clone --branch v<TOOLS_VERSION> --depth 1 https://github.com/citusdata/tools.git
cd tools
make uncrustify/.install

Clone the pinned tag, never the default branch: the default branch moves ahead of what CI runs.

If root installation is unavailable, install to a private prefix and put that prefix on PATH. The important invariant is that make reindent resolves both of the current branch's pinned versions: the uncrustify release from STYLEGUIDE.md, and citus_indent from citusdata/tools at v<TOOLS_VERSION>.

Show full SKILL.md (291 more words)Show less

3. Run make reindent

Return to the checked-out Citus worktree. Before running anything, make sure it has no uncommitted changes to tracked files, staged or unstaged:

bash
git status --porcelain --untracked-files=no

If that prints anything, stop and report it. Do not stash, reset, or commit those changes yourself: they belong to the caller, and mixing them into the reindent commit would hide unrelated edits inside a "style-only" commit. Pre-existing untracked files are fine; step 4 never stages them.

Then run:

bash
make reindent

This runs citus_indent, black, isort, and the other fixers in ci/fix_style.sh.

4. Diff and commit

Inspect the complete result before committing:

bash
git status --short
git diff --check
git diff

Formatter-version skew is the first suspect if unrelated files or unrelated lines changed. Do not commit a broad rewrite. Re-check both pins from step 1 — the uncrustify version in STYLEGUIDE.md and style_checker_tools_version in .github/workflows/build_and_test.yml — restore only the changes made by this reindent run, and rerun with the correct tooling.

If there is no diff, report that make reindent made no changes and do not create an empty commit.

If the diff contains only the intended style corrections, stage only modifications to tracked files and commit:

bash
git add -u
git commit -m "Apply make reindent"

Do not use git add -A or git add .: those also stage untracked files that have nothing to do with this run (local notes, build outputs, scratch scripts). Because step 3 started from a tree with no tracked changes, everything git add -u stages was produced by this reindent run. The fixers only rewrite files that are already tracked, so if git status --short shows a new untracked file after the run, do not add it. Report it instead.

Stop after the local commit. Do not push. Pushing (and where the branch lives, and what happens to CI afterward) is entirely the caller's decision — only push if separately instructed to.

© citusdata, AGPL-3.0. 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 .github/skills/citus-check-style-reindent of citusdata/citus.

Open the folder on GitHubat commit d41eec3

Compare with similar skills

Citus Check Style Reindent 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.

Citus Check Style Reindent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Citus Check Style Reindent this skillcitusdata/citus13k—~1.5kAutomated safety check: NotesAGPL-3.0
SQL Database Support for pRESTprest/prest4.6k—~1.6kAutomated safety check: PassMIT
Diesel Guardayarotsky/diesel-guard121—~3.1kAutomated safety check: PassMIT
Openqodexopenqodex/openqodex573—~2.5kAutomated safety check: PassApache-2.0
New Lintsupabase/splinter281—~2.9kAutomated safety check: NotesNone
Update Dependenciesalorence/django-modern-rpc111—~1.3kAutomated safety check: PassMIT

Similar skills

  • Guides classifying, gap-analyzing and scaffolding support for a new SQL database in pREST, from Postgres-compatible variants to entirely new dialects.

    4.6k GitHub stars~1.6k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Diesel Guard

    ayarotsky/diesel-guard

    Lints Diesel and SQLx Postgres migrations for unsafe schema changes that lock tables or cause downtime, and authors custom Rhai checks.

    121 GitHub stars~3.1k tokensUpdated yesterday
    DatabasesAuto-check passed
  • Openqodex

    openqodex/openqodex

    Code review for the current change, before it is pushed. An agent skill from openqodex/openqodex.

    573 GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • New Lint

    supabase/splinter

    Official

    Create a new splinter lint — a SQL view that checks for a database anti-pattern.

    281 GitHub stars~2.9k tokensUpdated 12 days ago
    DevelopmentAuto-check: notes
  • Update Dependencies

    alorence/django-modern-rpc

    Routine update of all project dependencies — uv itself, uv.lock (all groups), tool versions pinned in GitHub workflows and .pre-commit-config.yaml (uv, ruff, mypy...), and SHA-pinned GitHub Actions.

    111 GitHub stars~1.3k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Python Pypi Package Builder

    github/awesome-copilot

    Official

    End-to-end skill for building, testing, linting, versioning, and publishing a production-grade Python library to PyPI.

    40k GitHub starsUsed in 1 repo~4.6k tokens
    DevelopmentAuto-check passed

More from citusdata/citus

  • Citus Merge Loop

    citusdata/citus

    Take a list of citusdata/citus PR links or numbers and merge each one independently: sync it with its base branch, fix a red check-style job with make reindent, retry other red checks a bounded…

    13k GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Citus Backport

    citusdata/citus

    Backport one or more merged citusdata/citus main commits/PRs onto the active release branches.

    13k GitHub stars~3.2k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Citus Check Style Reindent

What does Citus Check Style Reindent do?

Fix a failing citusdata/citus check-style job by running make reindent with the exact uncrustify/citusindent versions the currently checked-out branch pins (read from its own STYLEGUIDE.md and its…. Citus Check Style Reindent is an agent skill from citusdata/citus.yml), then inspect and commit the resulting style-only changes locally.

When should I use Citus Check Style Reindent?

Citus Check Style Reindent fits situations like: check-style fails on whatever Citus branch is already checked out; asked to run make reindent safely.

How do I install Citus Check Style Reindent in Claude Code?

Run `npx skills add citusdata/citus --skill citus-check-style-reindent -a claude-code`. Or copy the skill folder (.github/skills/citus-check-style-reindent in citusdata/citus) into .claude/skills/citus-check-style-reindent in your project. Claude Code loads it when a task matches its description.

How do I install Citus Check Style Reindent in Codex?

Run `npx skills add citusdata/citus --skill citus-check-style-reindent -a codex`. Or copy the skill folder (.github/skills/citus-check-style-reindent in citusdata/citus) into .agents/skills/citus-check-style-reindent in your project. Codex loads it when a task matches its description.

Can I use Citus Check Style Reindent 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 citusdata/citus --skill citus-check-style-reindent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/citus-check-style-reindent, .gemini/skills/citus-check-style-reindent, .github/skills/citus-check-style-reindent and .opencode/skills/citus-check-style-reindent in your project.

What does Citus Check Style Reindent need to run?

Going by SKILL.md and its folder, Citus Check Style Reindent needs the command-line tools its instructions call (git, make, curl, cmake and gh).

Does Citus Check Style Reindent access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Citus Check Style Reindent safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Citus Check Style Reindent use?

Citus Check Style Reindent is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Citus Check Style Reindent use?

About 1.5k tokens (SKILL.md is roughly 6.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 Citus Check Style Reindent?

Skills that share tags, products or a category with Citus Check Style Reindent: SQL Database Support for pREST (prest/prest, 4.6k stars), Diesel Guard (ayarotsky/diesel-guard, 121 stars), Openqodex (openqodex/openqodex, 573 stars) and New Lint (supabase/splinter, 281 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Citus Check Style Reindent?

citusdata (a GitHub organization) maintains it in citusdata/citus, which has 12,803 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 8, 2026.

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