Skip to content

jkroepke/okf-crossplane-v2 / .agents/skills/okf

Explicit-only workflow that builds or updates a source-backed Open Knowledge Format catalog for Crossplane core, providers, functions, SDKs, tools, official documentation, historical design context, and examples. Never invoke implicitly; the user must invoke `$okf`, `/skill:okf`, or `/okf`.

FileKindSize
SKILL.mdskill md21.6 KB
agents/openai.yamlconfig273 B
references/evidence-contract.mdmarkdown7.3 KB
references/okf-profile.mdmarkdown2.7 KB
references/okf-spec.mdmarkdown36.7 KB
references/sources.yamlconfig18.3 KB

references/okf-profile.md

View on GitHub
# Crossplane OKF profile

This profile adds authoring guidance without narrowing OKF v0.2 conformance.

## Required by OKF v0.2

- Every non-reserved Markdown concept has parseable YAML frontmatter.
- Every concept has a non-empty `type`.
- `index.md` and `log.md` follow their reserved roles.

## Recommended frontmatter

```yaml
---
type: Crossplane Function
title: function-go-templating
description: One sentence supported by the cited sources.
resource: https://github.com/crossplane-contrib/function-go-templating
tags: [crossplane, function]
generated: { by: "process:crossplane-okf-generation", at: "2026-07-11T00:00:00Z" }
sources:
  - id: package-metadata
    resource: https://github.com/crossplane-contrib/function-go-templating/blob/<full-SHA>/package/crossplane.yaml
    title: Function package metadata
source_repository: crossplane-contrib/function-go-templating
source_commit: <full SHA>
source_paths:
  - package/crossplane.yaml
---
```

Use extension fields only when populated by evidence. Preserve unknown fields.

Use the OKF actor convention for `generated.by` and `verified[].by`:
`<producer>/<version>` for tools or agents, `process:<id>` for automated
processes, and `human:<id>` for people. Omit `verified` unless the recorded
verification actually occurred. An absent `status` means `stable`; do not add
lifecycle or staleness metadata without evidence.

## Preferred concept types

- `Crossplane Core Concept`
- `Crossplane API`
- `Crossplane CLI Command`
- `Crossplane Provider`
- `Crossplane Managed Resource`
- `Crossplane Function`
- `Crossplane Function Input`
- `Crossplane Development Guide`
- `Crossplane Test Tool`
- `Crossplane Example`
- `Terraform Resource Reference`
- `Reference`

These values are conventions, not a closed taxonomy.

## Body structure

Use only sections that add evidence-backed value:

- `# Overview`
- `# Schema`
- `# Behavior`
- `# Examples`
- `# Computation` for an `Attested Computation`
- `# Relationships`
- `# Limitations`

Put provenance in frontmatter `sources`, with one concrete `resource` per entry.
Give claim-bearing entries stable `id` values and attribute claims with matching
keyed Markdown footnotes, for example `[^package-metadata]`. Footnote definitions
may repeat the human-readable source link. Prefer commit-pinned GitHub blob URLs
with line anchors. Do not emit the superseded v0.1 `# Citations` section or
`timestamp` field.

## Granularity

- One independently useful concept per file.
- Keep package knowledge separate from API schema, runtime behavior, and examples.
- Do not mirror every generated type by default. Generate at resource level only when requested or when the resource is needed by another concept.
- Use `index.md` for progressive disclosure instead of large overview pages.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall