devops-platform-engineering

A platform-engineering guide for building internal developer platforms. These are company tools that let developers create services, find system information, and manage infrastructure through standard workflows.

In plain words
What is it for?
Use it when building developer portals, Backstage catalogues, GitOps deployments with ArgoCD or Flux, self-service infrastructure APIs, or standard templates for new services.
Why use it?
Teams often repeat setup and deployment work or rely on scattered infrastructure knowledge. This guide helps define self-service paths, service catalogues, Git-based deployment, and standard project templates.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/ai-shell-team/aish/devops-platform-engineering
Any agent
npx skills add AI-Shell-Team/aish --skill devops-platform-engineering
Clone the repo
git clone --depth 1 https://github.com/AI-Shell-Team/aish

Made for: Claude Code, Codex.

Per session 47 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,032 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00047 $0.01032
Opus 5 $0.00023 $0.00516
Sonnet 5 $0.00009 $0.00206
Haiku 4.5 $0.00005 $0.00103

Measured yesterday against content hash 592311085779, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

devops-platform-engineering scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/devops-platform-engineering/SKILL.md · 172 lines

How it starts

The opening of the file, as written. The whole thing — 172 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Platform Engineering Expert

Senior DevOps engineer specializing in internal developer platforms, self-service infrastructure, and developer experience optimization.

Role Definition

You are a platform engineering expert with deep experience in:

  • Self-Service Infrastructure: Automated provisioning, templates, APIs
  • Service Catalogs: Backstage, service discovery, documentation
  • GitOps: ArgoCD, Flux, declarative deployments
  • Golden Paths: Opinionated templates, best practices by default
  • Developer Experience: Productivity metrics, tooling, onboarding

When to Use This Skill

  • Building internal developer platforms (IDPs)
  • Setting up Backstage service catalogs
  • Implementing GitOps workflows with ArgoCD
  • Creating golden path templates for new services
  • Designing self-service infrastructure APIs

Platform Principles

  • Self-service first: Reduce manual work to <10%
  • Golden paths: Pre-approved, opinionated templates
  • Developer experience: Measure and optimize productivity
  • Platform as product: Treat with product mindset

Self-Service with Crossplane

# Composition for self-service database
apiVersion: apiextensions.crossplane.io/v1
kind: Composition
metadata:
  name: postgres-database
spec:
  compositeTypeRef:
    apiVersion: platform.example.com/v1alpha1
    kind: Database
  resources:
    - name: rds-instance
      base:
        apiVersion: rds.aws.crossplane.io/v1alpha1
        kind: DBInstance
        spec:
          forProvider:
            dbInstanceClass: db.t3.micro
            engine: postgres
            engineVersion: "15"

Backstage Service Template

# templates/microservice/template.yaml
apiVersion: scaffolder.backstage.io/v1beta3
kind: Template
metadata:
  name: microservice-template
  title: Microservice Golden Path
spec:
  owner: platform-team
  type: service
  parameters:
    - title: Service Info
      properties:
        name:
          type: string
        owner:
          type: string
          ui:field: OwnerPicker
        language:
          type: string
          enum: [go, python, nodejs, java]
  steps:
    - id: fetch
      action: fetch:template
    - id: publish
      action: publish:github
    - id: register
      action: catalog:register

Read the full file on GitHub · 172 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 172 lines · 47 tokens per session scan A 592311085779

Subscribe to this mod's changes

devops-platform-engineering is a skill published in the GitHub repository AI-Shell-Team/aish (522 stars, last pushed 6d ago), licensed Apache-2.0. It adds 47 tokens to every session and 1,032 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

taskgo

Maintains a private Git-backed personal project and task control repository using concise current Markdown, derived Git history, ADRs, and status synchronization. Use when tracking tasks, updating project status (STATUS.md), managing ADRs, synchronizing tracker state, or delegating tasks to external agents across…

ithinkihaveacat/dotfiles · 62 tokens

mbo-plan

Plan a new objective end-to-end in this repo's docs/mbo Management-By-Objective system — turn a GitHub issue or a gss draft-PR worktree into consistent design/spec/plan artifacts and track it in docs/mbo/index.md. Use this whenever the user wants to START planning or designing a new feature, skill, CLI, or service…

sfc-gh-eraigosa/dotfiles · 260 tokens

wear-widget

Workflows, checklists, and scripts for reverse-engineering, analyzing, and extracting Wear OS and Android widgets (Glance, AppWidget, ProtoLayout Tiles). Covers manifest declarations, XML configurations, preview asset extraction, and AVD rendering. Use when analyzing APK widget features, extracting widget…

ithinkihaveacat/dotfiles · 81 tokens

jetpack

Looks up AndroidX and Jetpack library facts that change between releases: current artifact versions (ALPHA, BETA, RC, STABLE, SNAPSHOT, build IDs), Maven coordinates for classes/packages, direct dependencies, and published source code. Use when looking up AndroidX/Jetpack library versions, finding Maven coordinates…

ithinkihaveacat/dotfiles · 98 tokens

emumanager

Manages Android SDKs, system images, emulators, and Android Virtual Devices (AVDs). Provides workflows for bootstrapping the SDK, downloading images, and creating, starting, or stopping AVDs across mobile, Wear OS, TV, and Automotive form factors. Use when setting up Android SDK tools, launching or debugging…

ithinkihaveacat/dotfiles · 84 tokens

agent-review

Conducts independent, read-only code reviews of branches, diffs, commits, working trees, or pull requests using external CLI agents (Codex, Claude, agy) or a synthesized review workflow. Focuses strictly on actionable defects and evidence-based findings. Use when reviewing code changes, requesting a second opinion on…

ithinkihaveacat/dotfiles · 91 tokens