author-composition SKILL.md skillA

author-composition from upbound/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add upbound/skills/author-composition@git:20261012.20c120e

Pins git:20261012.20c120e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
upbound/skills
Path
skills/author-composition/SKILL.md
Versions recorded
2
Latest version
git:20261012.20c120e, committed Oct 12, 2026
First version recorded
Oct 8, 2026
Size
13,086 bytes
Repository stars
4
License
Apache-2.0

Use this skill when the user asks to create, extend, modify, or debug a Crossplane composition function in a control-plane project — in any language (KCL, Python, TypeScript, Go). Detects the function language and applies the matching reference. Also use when asked about Crossplane v2 composition patterns, model/type import paths, namespaced `.m.` APIs, or why a composition renders green but the resource never reconciles. For authoring the tests themselves use author-tests; for XRD design use…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Composition Authoring

Author and modify Crossplane composition functions, in any language `up function generate`
supports, test first.

## Before you start

A composition's *meaning* is language-agnostic; only its *syntax* differs. Read three layers:
the charter (the rules), [patterns.md](references/patterns.md) (what each pattern means), and
your language's file under `control-plane-project-charter/references/languages/` (the
syntax).

- **Reviewing function code:** the checks are in
  `control-plane-project-charter/references/charter/review.md`. **A test passes but the resource
  misbehaves on a control plane:**
  [patterns.md](references/patterns.md#a-green-test-with-a-misbehaving-resource).
- Tests → `author-tests`; XRD design and scaffolding → `author-configuration-package`; the
  gate and deploying → `verify-configuration`; live cloud runs → `e2e-test-configuration`;
  migrating a function to v2 → `plan-v2-migration` (the function-side points:
  [patterns.md](references/patterns.md#migrating-a-function-to-v2)).

## Binding rules — they hold even if you open nothing else

Load `control-plane-project-charter` first, or read its `SKILL.md` beside this skill's
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add upbound/skills/author-composition@sha256:365896cd18e0665a

The line at the top of this page pins the label git:20261012.20c120e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_6lif6hkew7dnsjyi.svg)](https://markdownregistry.com/a/art_6lif6hkew7dnsjyi)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Oct 8, 2026 and Oct 12, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261012.20c120e latest2026-10-12 20c120e 13,086 BA view · diff
git:20261008.17a6e1f2026-10-08 17a6e1f 12,968 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (13086 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

upbound/skills · 4 stars · license Apache-2.0 · pushed 2026-10-12 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_6lif6hkew7dnsjyi
GET https://markdownregistry.com/api/v1/resolve?ref=upbound/skills/author-composition
GET https://markdownregistry.com/api/v1/blob/365896cd18e0665a294c59d25a635e3b0287a99a8df08515b94d2fc34b5e4a8e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from upbound/skills

CLAUDE.md@.claude CLAUDE.md file
upbound/skills · .claude/CLAUDE.md
git:20260731.07ba1b1 · audit B · 4 stars
AGENTS.md AGENTS.md file
upbound/skills · AGENTS.md
git:20260731.07ba1b1 · audit A · 4 stars
author-configuration-package SKILL.md skill
upbound/skills · skills/author-configuration-package/SKILL.md · Use this skill when user requests to create, scaffold, modify, or extend a Crossplane configuration package. Handles…
git:20261012.c64c3d9 · audit A · 4 stars
author-tests SKILL.md skill
upbound/skills · skills/author-tests/SKILL.md · Use this skill when user requests to write, create, author, modify, refactor or plan refactoring of Crossplane…
git:20261012.20c120e · audit A · 4 stars
control-plane-project-charter SKILL.md skill
upbound/skills · skills/control-plane-project-charter/SKILL.md · Shared rules and per-language references for the Upbound control-plane-project skills - agent behaviour, the test-first…
git:20261012.d99944b · audit A · 4 stars
e2e-test-configuration SKILL.md skill
upbound/skills · skills/e2e-test-configuration/SKILL.md · Run Crossplane E2E tests (`up test run --e2e`) for a control-plane project, locally on kind (`--local`) or on an…
git:20261012.5cb0c70 · audit A · 4 stars
execute-v2-migration SKILL.md skill
upbound/skills · skills/execute-v2-migration/SKILL.md · Use this skill when user requests to execute or implement a Crossplane v2 migration plan. Executes the migration plan…
git:20261012.812f1e7 · audit A · 4 stars
plan-v2-migration SKILL.md skill
upbound/skills · skills/plan-v2-migration/SKILL.md · Use this skill when user requests to migrate, upgrade, or plan migration to Crossplane v2. Analyzes an existing v1…
git:20261012.a0b20d2 · audit A · 4 stars
upbound-hub SKILL.md skill
upbound/skills · skills/upbound-hub/SKILL.md · Query and mutate Upbound Hub, the central API for an Upbound Platform deployment, which gives one cross-fleet view of…
git:20260915.2798d9f · audit A · 4 stars
verify-configuration SKILL.md skill
upbound/skills · skills/verify-configuration/SKILL.md · Verify a Crossplane configuration package before committing - build it, run its composition tests and read the render…
git:20261012.5cb0c70 · audit A · 4 stars

Every file in upbound/skills

Browse by kind, by grade A, or by owner.