Agent skill

Tools

by astronomer in astronomer/astronomer

A skill your agent uses when writing, editing, or reviewing command-line tools and helper scripts in this repo (things in bin/).

Custom licenceAuto-check passedDevOps & Cloud

Install Tools

skills CLI
$ npx skills add astronomer/astronomer --skill tools -a claude-code

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

GitHub CLI
$ gh skill install astronomer/astronomer tools --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/astronomer/astronomer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/tools .claude/skills/tools && 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
tools
GitHub stars
491
Token cost
~1.1k tokens
SKILL.md length
481 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
Custom licence

At a glance

A skill your agent uses when writing, editing, or reviewing command-line tools and helper scripts in this repo (things in bin/).

  • Works in 4 steps: Tools live in bin/ as executable… → Every tool parses arguments with… → help and insufficient/invalid arguments… → …
  • Reviewing command-line tools and helper scripts in this repo (things in bin/)
  • SKILL.md covers Critical Rules, Non-destructive by default and Checklist for a new or edited…
  • Calls uv

What it does

Tools is an agent skill from astronomer/astronomer. Use when writing, editing, or reviewing command-line tools and helper scripts in this repo (things in bin/). Covers where tools live, argument parsing with --help, and the rule that a tool must not perform destructive or state-mutating operations by default.

Its SKILL.md is about 1.1k 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 DevOps & Cloud, covering Container orchestration. It works with Kubernetes and Python. The repository describes itself as: Helm Charts for the Astronomer Platform, Apache Airflow as a Service on Kubernetes.

When your agent uses it

  • Reviewing command-line tools and helper scripts in this repo (things in bin/)
  • Tasks that involve Container orchestration

Example prompts

  • “/tools”

Requirements

  • Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Tools live in bin/ as executable scripts: a shebang (#!/usr/bin/env python3 for Python) plus chmod +x. Python tools run via uv run bin/.py.
  2. Every tool parses arguments with argparse (or the language equivalent) so --help works and every argument is self-documenting. Parse…
  3. help and insufficient/invalid arguments must do no work. They print usage and exit before any side effect. argparse gives this for free as…
  4. A tool must not perform a destructive or state-mutating operation by default. Merely running it (or running it to read --help) must not…

What it can do on your machine

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

    • uv

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

  • Network

    No URLs in SKILL.md. Its commands use uv, 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

Tools loads about 1.1k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 481 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 481 words (~1,068 tokens).

“Repo tooling (setup scripts, one-off utilities, anything a human or CI invokes directly) lives in bin/ and follows a few rules so tools are discoverable, self-documenting, and safe to run by accident.”

— opening of SKILL.md by astronomer, Custom licence
name
tools

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/tools of astronomer/astronomer.

Open the folder on GitHubat commit 9439ebb

Compare with similar skills

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

Tools compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tools this skillastronomer/astronomer491—~1.1kAutomated safety check: PassCustom licence
Vetatilladeniz/Kubeli3872 repos~1.6kAutomated safety check: PassMIT
Dstack Presetsdstackai/dstack2.3k—~403Automated safety check: PassMPL-2.0
Alibabacloud Ecs Sec Userspacealiyun/alibabacloud-ecs-troubleshoot-skills148—~2.6kAutomated safety check: NotesApache-2.0
Dstackdstackai/dstack2.3k—~6.2kAutomated safety check: WarnMPL-2.0
Asdfjjmartres/opencode133—~2.1kAutomated safety check: NotesMIT

Similar skills

  • Vet

    atilladeniz/Kubeli

    Run vet immediately after ANY logical unit of code changes. An agent skill from atilladeniz/Kubeli.

    387 GitHub starsUsed in 2 repos~1.6k tokens
    DevOps & CloudAuto-check passed
  • Dstack Presets

    dstackai/dstack

    Create and manage dstack presets: a toolkit that streamlines model inference optimization with agents, and a portable preset format.

    2.3k GitHub stars~403 tokensUpdated today
    DevOps & CloudAuto-check passed
  • Alibabacloud Ecs Sec Userspace

    aliyun/alibabacloud-ecs-troubleshoot-skills

    Linux 用户态安全入侵检测与取证工具,专为 AI Agent 设计。自动判断服务器是否被入侵, 提供完整证据链和可执行修复建议。51 个安全分析器覆盖进程/网络/认证/持久化/Rootkit/ 恶意软件/内存取证/容器逃逸等 12 类检测维度,10 个数据采集器全面采集系统状态, 映射 103+ MITRE ATT&CK 技术,支持 standalone/docker/k8s 三种部署模式。

    148 GitHub stars~2.6k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: notes
  • Dstack

    dstackai/dstack

    dstack is an open-source control plane for GPU provisioning and orchestration across GPU clouds, Kubernetes, and on-prem clusters.

    2.3k GitHub stars~6.2k tokensUpdated today
    DevOps & CloudAuto-check: warnings
  • Asdf

    jjmartres/opencode

    A skill your agent uses whenever the user wants to install, configure, or use asdf (asdf-vm), the universal version manager.

    133 GitHub stars~2.1k tokensUpdated 5 mo ago
    DevOps & CloudAuto-check: notes
  • Kubernetes Operator

    alirezarezvani/claude-skills

    A skill your agent uses when building a Kubernetes Operator — custom controllers that reconcile CRD state.

    28k GitHub stars~2.8k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed

More from astronomer/astronomer

  • Chart Tests

    astronomer/astronomer

    A skill your agent uses when writing, editing, reviewing, or running Helm chart tests for the Astronomer APC repository.

    491 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • Functional Tests

    astronomer/astronomer

    A skill your agent uses when writing, editing, reviewing, or running functional (end-to-end) tests for the Astronomer APC repository.

    491 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Helm Chart

    astronomer/astronomer

    A skill your agent uses for Helm chart work - creating charts, modifying existing charts, values design, testing.

    491 GitHub stars~6.5k tokensUpdated today
    Auto-check passed

Categories

Questions about Tools

What does Tools do?

A skill your agent uses when writing, editing, or reviewing command-line tools and helper scripts in this repo (things in bin/). Tools is an agent skill from astronomer/astronomer. Use when writing, editing, or reviewing command-line tools and helper scripts in this repo (things in bin/).

When should I use Tools?

Tools fits situations like: reviewing command-line tools and helper scripts in this repo (things in bin/); tasks that involve Container orchestration.

How do I install Tools in Claude Code?

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

How do I install Tools in Codex?

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

Can I use Tools 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 astronomer/astronomer --skill tools -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tools, .gemini/skills/tools, .github/skills/tools and .opencode/skills/tools in your project.

What does Tools need to run?

Going by SKILL.md and its folder, Tools needs the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Tools access the network?

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

Is Tools 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 Tools use?

Tools has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Tools use?

About 1.1k tokens (SKILL.md is roughly 4.3k 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 Tools?

Skills that share tags, products or a category with Tools: Vet (atilladeniz/Kubeli, 387 stars), Dstack Presets (dstackai/dstack, 2.3k stars), Alibabacloud Ecs Sec Userspace (aliyun/alibabacloud-ecs-troubleshoot-skills, 148 stars) and Dstack (dstackai/dstack, 2.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tools?

astronomer (a GitHub organization) maintains it in astronomer/astronomer, which has 491 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 6, 2026.

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