Agent skill

Py Package Check

by ipea in ipea/geobr

Run the Python package release gate for geobr — sync the locked environment, run the offline and network test suites, build the distribution, and review the source against the Python conventions.

No licenceAuto-check: notesTesting & QA

Install Py Package Check

skills CLI
$ npx skills add ipea/geobr --skill py-package-check -a claude-code

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

GitHub CLI
$ gh skill install ipea/geobr py-package-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/ipea/geobr.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/py-package-check .claude/skills/py-package-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
py-package-check
GitHub stars
959
Token cost
~1.4k tokens
SKILL.md length
408 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
None found

At a glance

Run the Python package release gate for geobr — sync the locked environment, run the offline and network test suites, build the distribution, and review the source against the Python conventions.

  • Works in 6 steps: Toolchain pre-flight — this is the gate… → Sync the locked environment → Test → …
  • The user says check the python package
  • SKILL.md covers Constraints, Phase 0: Toolchain pre-flight…, Phase 1: Sync the locked… and Phase 2: Test, plus 4 more sections
  • Calls uv and pip; reaches docs.astral.sh

What it does

Py Package Check is an agent skill from ipea/geobr. Run the Python package release gate for geobr — sync the locked environment, run the offline and network test suites, build the distribution, and review the source against the Python conventions. Use when the user says "check the python package", "run pytest", "is the python side ready", "prepare a PyPI release", or points at python-package/. Produces a check report in qualityreports/. Mirrors .github/workflows/Python-CMD-check.yaml so local and CI cannot diverge.

Its SKILL.md is about 1.4k 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 Testing & QA, covering Unit testing and Test generation. It works with Python, GitHub Actions and pytest. The repository describes itself as: Easy access to official spatial data sets of Brazil in R and Python.

When your agent uses it

  • The user says check the python package
  • Is the python side ready
  • Prepare a PyPI release
  • Points at python-package/

Example prompts

  • “check the python package”
  • “run pytest”
  • “is the python side ready”
  • “/py-package-check”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Read, Grep, Glob, Bash, Write, Task, Monitor

Workflow steps

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

  1. Toolchain pre-flight — this is the gate on the gate
  2. Sync the locked environment
  3. Test
  4. Build
  5. Source review (skip with --no-review)
  6. Verdict

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • Bash
    • Write
    • Task
    • Monitor

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • pip

    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:

    • docs.astral.sh

    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

Py Package Check loads about 1.4k tokens when it runs. Until then it costs about 122 tokens; SKILL.md has 408 words of instructions outside code blocks.

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

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.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Grep, Glob, Bash, Write, Task, Monitor

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

Without a licence we can't republish the file, so here is its outline and opening line. It has 408 words (~1,401 tokens).

“The Python counterpart to /r-package-check. Sync → test → build → review, then a verdict.”

— opening of SKILL.md by ipea
name
py-package-check
allowed-tools
Read, Grep, Glob, Bash, Write, Task, Monitor
author
geobr
version
1.0.0
argument-hint
[--network] [--no-review]
disable-model-invocation
true
effort
high

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/py-package-check of ipea/geobr.

Open the folder on GitHubat commit 0969f92

Compare with similar skills

Py Package 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.

Py Package Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Py Package Check this skillipea/geobr959—~1.4kAutomated safety check: NotesNone
Adk Verify Snippetsgoogle/adk-python22k—~1.4kAutomated safety check: PassApache-2.0
Hermetic Python Unit TestsdimensionalOS/dimos4.6k—~1.4kAutomated safety check: PassCustom licence
Simple Modern Uvjlevy/simple-modern-uv301—~1.9kAutomated safety check: PassMIT
Test Coverage Reviewareed1192/finance-news-aggregator149—~2.6kAutomated safety check: PassMIT
Testing Livekit Agentslivekit-examples/agent-starter-python2641 repos~1.9kAutomated safety check: PassMIT

Similar skills

  • Adk Verify Snippets

    google/adk-python

    Official

    Checks that every Python code block in a Markdown file actually compiles and runs, by extracting each block to a temporary file, executing it in an isolated subprocess, and writing a pass/fail…

    22k GitHub stars~1.4k tokensUpdated today
    Testing & QAAuto-check passed
  • Hermetic Python Unit Tests

    dimensionalOS/dimos

    Rules for writing, fixing and reviewing pytest unit tests that are hermetic: behavior-focused, deterministic, isolated and cheap to run.

    4.6k GitHub stars~1.4k tokensUpdated today
    Testing & QAAuto-check passed
  • Simple Modern Uv

    jlevy/simple-modern-uv

    Start, selectively modernize, fully migrate, or update Python projects using simple-modern-uv practices: uv, ruff, BasedPyright, pytest, GitHub Actions CI, and tag-driven PyPI publishing.

    301 GitHub stars~1.9k tokensUpdated 1 mo ago
    Testing & QAAuto-check passed
  • Test Coverage Review

    areed1192/finance-news-aggregator

    Audit, plan, write, and verify unit tests for Python projects using pytest.

    149 GitHub stars~2.6k tokensUpdated 5 mo ago
    Testing & QAAuto-check passed
  • Testing Livekit Agents

    livekit-examples/agent-starter-python

    Writes turn-level tests for a LiveKit agent in the user's normal test suite: pytest (Python) or Vitest (Node.js).

    264 GitHub starsUsed in 1 repo~1.9k tokens
    Testing & QAAuto-check passed
  • Mutation Test Strength Audit

    buildfastwithai/gen-ai-experiments

    Measures how well a Python pytest suite catches behavior changes through diff-scoped mutation testing, then proposes and verifies tests for surviving mutants.

    785 GitHub stars~641 tokensUpdated 15 days ago
    Testing & QAAuto-check passed

More from ipea/geobr

All 9 skills in this repo
  • Learn

    ipea/geobr

    Extract reusable knowledge from the current session into a persistent skill.

    959 GitHub starsUsed in 2 repos~1.2k tokens
    Auto-check: notes
  • Checkpoint

    ipea/geobr

    Save a structured state snapshot the next session can resume from — active plan, decisions and why, file pointers with line numbers, open questions, next 1-3 actions, and what to deliberately forget.

    959 GitHub stars~1.4k tokensUpdated 10 days ago
    Auto-check: notes
  • Deep Audit

    ipea/geobr

    Deep consistency audit of the geobr repository — configuration, documentation, and the two packages.

    959 GitHub stars~1.8k tokensUpdated 10 days ago
    Auto-check: notes
  • Diagnose

    ipea/geobr

    Root-cause a failing or wrong geobr call with a disciplined check-the-environment-first loop instead of guessing.

    959 GitHub stars~1.5k tokensUpdated 10 days ago
    Auto-check passed
  • Parity Check

    ipea/geobr

    Check R↔Python API parity across geobr's two packages — which read functions exist on one side but not the other, and where matched functions disagree on argument names, defaults, or the metadata…

    959 GitHub stars~1.4k tokensUpdated 10 days ago
    Auto-check: notes
  • R Package Check

    ipea/geobr

    Run the full R package release gate — regenerate docs, run the test suite, run R CMD check --as-cran, and triage every ERROR / WARNING / NOTE against CRAN policy before a release or submission.

    959 GitHub stars~1.5k tokensUpdated 10 days ago
    Auto-check: notes

Categories

Questions about Py Package Check

What does Py Package Check do?

Run the Python package release gate for geobr — sync the locked environment, run the offline and network test suites, build the distribution, and review the source against the Python conventions. Py Package Check is an agent skill from ipea/geobr. Run the Python package release gate for geobr — sync the locked environment, run the offline and network test suites, build the distribution, and review the source against the Python conventions.

When should I use Py Package Check?

Py Package Check fits situations like: the user says check the python package; is the python side ready; prepare a PyPI release; points at python-package/.

How do I install Py Package Check in Claude Code?

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

How do I install Py Package Check in Codex?

Run `npx skills add ipea/geobr --skill py-package-check -a codex`. Or copy the skill folder (.claude/skills/py-package-check in ipea/geobr) into .agents/skills/py-package-check in your project. Codex loads it when a task matches its description.

Can I use Py Package 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 ipea/geobr --skill py-package-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/py-package-check, .gemini/skills/py-package-check, .github/skills/py-package-check and .opencode/skills/py-package-check in your project.

What does Py Package Check need to run?

Going by SKILL.md and its folder, Py Package Check needs the command-line tools its instructions call (uv and pip). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Grep, Glob, Bash, Write, Task, Monitor.

Does Py Package Check access the network?

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

Is Py Package Check safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Py Package Check use?

No licence was found for Py Package Check or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Py Package Check use?

About 1.4k tokens (SKILL.md is roughly 5.6k 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 Py Package Check?

Skills that share tags, products or a category with Py Package Check: Adk Verify Snippets (google/adk-python, 22k stars), Hermetic Python Unit Tests (dimensionalOS/dimos, 4.6k stars), Simple Modern Uv (jlevy/simple-modern-uv, 301 stars) and Test Coverage Review (areed1192/finance-news-aggregator, 149 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Py Package Check?

ipea (a GitHub organization) maintains it in ipea/geobr, which has 959 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on September 27, 2026.

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