Agent skill

OpenPitrix Application Management

by kubesphere in kubesphere/kubesphere

Explains KubeSphere's OpenPitrix application management: repositories, app templates and versions, reviews, releases and categories, plus fixing install and upgrade problems.

Custom licenceAuto-check passedDevOps & Cloud

Install OpenPitrix Application Management

skills CLI
$ npx skills add kubesphere/kubesphere --skill openpitrix -a claude-code

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

GitHub CLI
$ gh skill install kubesphere/kubesphere openpitrix --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/kubesphere/kubesphere.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openpitrix .claude/skills/openpitrix && 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
openpitrix
GitHub stars
17k
Token cost
~9.4k tokens
SKILL.md length
2,022 words
Files
2
Skills in repo
32
Repo updated
First seen
Licence
Custom licence

At a glance

Explains KubeSphere's OpenPitrix application management: repositories, app templates and versions, reviews, releases and categories, plus fixing install and upgrade problems.

  • Adding an application repository to the KubeSphere App Store and checking its sync state
  • SKILL.md covers Overview, Architecture, Navigation and Feature Coverage and Tool Selection, plus 8 more sections
  • Calls python, kubectl and curl
  • Looking up app templates, versions, review states or categories

What it does

OpenPitrix is the application management layer behind the KubeSphere App Store, and this skill gives the agent a working model of it. For KubeSphere 4.x it points to the application.kubesphere.io/v2 API group and maps each v2 object to its older OpenPitrix counterpart: Repo, Application, ApplicationVersion, ApplicationRelease and Category.

It records the namespace and labels the data lives under, such as the extension-openpitrix namespace and the repository, app and version ID labels, and describes the controllers that load Helm repository indexes, clean up unused versions, install or upgrade releases through Helm executor Jobs and keep category counts. It also helps the agent decide whether a request about the app store concerns the workspace-level app management pages or the global App Store management extension.

When your agent uses it

  • Adding an application repository to the KubeSphere App Store and checking its sync state
  • Looking up app templates, versions, review states or categories
  • Finding out why an application release failed to install or upgrade
  • Mapping older OpenPitrix resource names to their KubeSphere 4.x equivalents

Example prompts

  • “List the app templates synced from the my-charts repository and their versions.”
  • “Which review state is the latest version of our nginx app template in?”
  • “The release of our monitoring app failed to upgrade, find out what went wrong.”
  • “What is the 4.x name for a HelmApplicationVersion?”

Requirements

  • kubectl access to a KubeSphere 4.x cluster with the OpenPitrix extension

What it can do on your machine

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

    • python
    • kubectl
    • curl
    • helm
    • jq

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

  • Network

    No URLs in SKILL.md. Its commands use kubectl, curl and helm, 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

OpenPitrix Application Management loads about 9.4k tokens when it runs. Until then it costs about 79 tokens; SKILL.md has 2,022 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~79
When it runs · the whole SKILL.md, loaded when a task matches
~9.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 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 2,022 words (~9,414 tokens).

“OpenPitrix is KubeSphere's application management capability for app repositories, app templates, versions, reviews, and app releases. In KubeSphere 4.x the runtime API group is application.kubesphere.io/v2; older OpenPitrix extension code used openpitrix.io/v2 CRUD APIs and openpitrix.io/v2alpha1 read/list wrappers over application.kubesphere.io/v1alpha1 resources.”

— opening of SKILL.md by kubesphere, Custom licence
name
openpitrix

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/openpitrix of kubesphere/kubesphere.

  • SKILL.md
  • evals/evals.json

Open the folder on GitHubat commit 04a29b5

Compare with similar skills

OpenPitrix Application Management 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.

OpenPitrix Application Management compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OpenPitrix Application Management this skillkubesphere/kubesphere17k—~9.4kAutomated safety check: PassCustom licence
Kubeshark Installerkubeshark/kubeshark12k—~3.6kAutomated safety check: NotesApache-2.0
LangBot Deployment Guidelangbot-app/LangBot18k—~1.2kAutomated safety check: NotesApache-2.0
Openbkn Deployopenbkn-ai/bkn-foundry629—~1.9kAutomated safety check: NotesCustom licence
KubeShark for KubernetesLukasNiessen/kubernetes-skill444—~1.2kAutomated safety check: PassMIT
Debug Openshell ClusterNVIDIA/OpenShell15k—~19kAutomated safety check: NotesApache-2.0

Similar skills

  • Kubeshark Installer

    kubeshark/kubeshark

    Installs and configures Kubeshark on a Kubernetes cluster, choosing between the quick CLI path and a Helm install with custom values.

    12k GitHub stars~3.6k tokensUpdated 7 days ago
    DevOps & CloudAuto-check: notes
  • LangBot Deployment Guide

    langbot-app/LangBot

    Deploys and configures a LangBot instance with Docker Compose or Kubernetes, covering config.yaml, the Box sandbox runtime, the plugin runtime and the global API key.

    18k GitHub stars~1.2k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes
  • Openbkn Deploy

    openbkn-ai/bkn-foundry

    Deploy or upgrade OpenBKN on a customer-authorized Linux server through the repository's deploy scripts, with preflight checks, explicit confirmation, secret handling, and post-deployment…

    629 GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • KubeShark for Kubernetes

    LukasNiessen/kubernetes-skill

    Keeps Kubernetes manifests, Helm charts and policies grounded by diagnosing six failure modes, such as insecure defaults and API drift, and loading only matching references.

    444 GitHub stars~1.2k tokensUpdated 24 days ago
    DevOps & CloudAuto-check passed
  • Debug Openshell Cluster

    NVIDIA/OpenShell

    Official

    Debug why an OpenShell gateway deployment is unhealthy, unreachable, or unable to create sandboxes.

    15k GitHub stars~19k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Aspire Monitoring

    CommunityToolkit/Aspire

    ANALYSIS SKILL - Observe Aspire apps: logs, traces, metrics, resource state, telemetry export, browser telemetry, and the standalone dashboard.

    629 GitHub stars~3.5k tokensUpdated yesterday
    DevOps & CloudAuto-check passed

More from kubesphere/kubesphere

All 32 skills in this repo
  • Creates and queries KubeSphere users, workspaces and projects and assigns built-in roles, defaulting to least privilege and never deleting anything.

    17k GitHub stars~3.1k tokensUpdated 2 mo ago
    Auto-check passed
  • KubeSphere ServiceMesh Manager

    kubesphere/kubesphere

    Installs, checks and troubleshoots the KubeSphere ServiceMesh extension (Istio, Kiali, Jaeger), including grayscale release, sidecar injection, topology and tracing issues.

    17k GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check passed
  • KubeEye Cluster Inspection

    kubesphere/kubesphere

    Deploys KubeEye on KubeSphere and writes InspectRule and InspectPlan resources to inspect cluster health, then retrieves the inspection reports.

    17k GitHub stars~3.6k tokensUpdated 2 mo ago
    Auto-check passed
  • KubeSphere NodeGroup Operations

    kubesphere/kubesphere

    Queries, creates, updates, binds and troubleshoots NodeGroup resources in the edgewize nodegroup project through a bundled authenticated API script.

    17k GitHub stars~1.9k tokensUpdated 2 mo ago
    Auto-check passed
  • WizTelemetry Platform Service

    kubesphere/kubesphere

    Installs and configures the WizTelemetry Platform Service extension for KubeSphere, the shared API server behind its observability extensions.

    17k GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Runs the lifecycle of FrontendExtension resources in a Kubernetes cluster: create, rebuild, package, publish, unpublish, delete and debug stuck states.

    17k GitHub stars~3.2k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about OpenPitrix Application Management

What does OpenPitrix Application Management do?

Explains KubeSphere's OpenPitrix application management: repositories, app templates and versions, reviews, releases and categories, plus fixing install and upgrade problems. OpenPitrix is the application management layer behind the KubeSphere App Store, and this skill gives the agent a working model of it.io/v2 API group and maps each v2 object to its older OpenPitrix counterpart: Repo, Application, ApplicationVersion, ApplicationRelease and Category.

When should I use OpenPitrix Application Management?

OpenPitrix Application Management fits situations like: adding an application repository to the KubeSphere App Store and checking its sync state; looking up app templates, versions, review states or categories; finding out why an application release failed to install or upgrade; mapping older OpenPitrix resource names to their KubeSphere 4.x equivalents.

How do I install OpenPitrix Application Management in Claude Code?

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

How do I install OpenPitrix Application Management in Codex?

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

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

What does OpenPitrix Application Management need to run?

Going by SKILL.md and its folder, OpenPitrix Application Management needs the command-line tools its instructions call (python, kubectl, curl, helm and jq). Our summary lists: kubectl access to a KubeSphere 4.x cluster with the OpenPitrix extension.

Does OpenPitrix Application Management access the network?

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

Is OpenPitrix Application Management 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 OpenPitrix Application Management use?

OpenPitrix Application Management 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 OpenPitrix Application Management use?

About 9.4k tokens (SKILL.md is roughly 38k 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 OpenPitrix Application Management?

Skills that share tags, products or a category with OpenPitrix Application Management: Kubeshark Installer (kubeshark/kubeshark, 12k stars), LangBot Deployment Guide (langbot-app/LangBot, 18k stars), Openbkn Deploy (openbkn-ai/bkn-foundry, 629 stars) and KubeShark for Kubernetes (LukasNiessen/kubernetes-skill, 444 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OpenPitrix Application Management?

kubesphere (a GitHub organization) maintains it in kubesphere/kubesphere, which has 17,059 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on July 15, 2026.

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