jkroepke/okf-crossplane-v2 / .agents/skills/okf
okf
VerifiedExplicit-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`.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 21.6 KB |
| agents/openai.yaml | config | 273 B |
| references/evidence-contract.md | markdown | 7.3 KB |
| references/okf-profile.md | markdown | 2.7 KB |
| references/okf-spec.md | markdown | 36.7 KB |
| references/sources.yaml | config | 18.3 KB |
references/sources.yaml
View on GitHubversion: 2
normative_sources:
- id: okf-spec
version: "0.2"
url: https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md
reference_sources:
- id: okf-demo-catalog
repository: GoogleCloudPlatform/knowledge-catalog
paths:
- toolbox/mdcode/demo/okf/catalog
primary_sources:
- id: crossplane
repository: crossplane/crossplane
kind: crossplane-core
release_policy: latest-stable
research_profiles:
core-crds:
agent: okf-crossplane-core-code-researcher
paths:
- cluster/crds
legacy_exclusions:
- Claims and claim APIs
- deprecated CompositeResourceDefinition v1 schema
- legacy v1 composite-resource semantics
- id: crossplane-cli
repository: crossplane/cli
kind: cli
domain: crossplane-cli
core_scope: false
- id: crossplane-runtime
repository: crossplane/crossplane-runtime
kind: provider-sdk
- id: crossplane-tools
repository: crossplane/crossplane-tools
kind: development-tools
- id: provider-template
repository: crossplane/provider-template
kind: provider-development-template
audience: developer
revision_policy: pin-current-main-commit-at-research-time
agent: okf-crossplane-researcher
paths:
- README.md
- PROVIDER_CHECKLIST.md
- .gitmodules
- Makefile
- go.mod
- apis
- internal/controller
- cmd/provider
- hack/helpers
- examples
- package
- cluster/local/integration_tests.sh
- LICENSE
version_dependencies:
crossplane-runtime: exact-version-from-go-mod
crossplane-build: exact-submodule-commit
crossplane-tools: exact-version-from-go-mod
supporting_sources:
- crossplane-build
- crossplane-tools
legacy_exclusions:
- Claims and claim references
- deprecated XRD v1 and legacy v1 XR semantics
- deprecated generator modes not selected by the template's modern APIs
- id: function-sdk-go
repository: crossplane/function-sdk-go
kind: function-sdk
audience: developer
agent: okf-function-sdk-go-researcher
- id: function-kro
repository: crossplane-contrib/function-kro
kind: function
audience: user
release_policy: discover-highest-stable-semver-tag
agent_set:
primary: okf-function-kro-researcher
kro: okf-function-kro-kro-researcher
paths:
- README.md
- package/crossplane.yaml
- package/input
- input
- fn.go
- fn_test.go
- main.go
- kro
- schemas
- example
- go.mod
- LICENSE
supporting_sources:
- function-kro-kro
legacy_exclusions:
- examples requiring Claims or claim references
- examples requiring deprecated v1 XRD or legacy v1 XR semantics
- id: function-go-templating
repository: crossplane-contrib/function-go-templating
kind: function
audience: user
release_policy: discover-highest-stable-semver-tag
agent_set:
primary: okf-function-go-templating-researcher
sprig: okf-function-go-templating-sprig-researcher
project_history: okf-function-go-templating-project-history-researcher
paths:
- README.md
- example
- package/input/gotemplating.fn.crossplane.io_gotemplates.yaml
- function_maps.go
- go.mod
supporting_sources:
- sprig
- function-go-templating-project-history
legacy_exclusions:
- README section v1 Composite Resources (Legacy)
- examples requiring Claims or claim references
- examples requiring deprecated v1 XRD or legacy v1 XR semantics
- id: function-environment-configs
repository: crossplane-contrib/function-environment-configs
kind: function
audience: user
release_policy: discover-highest-stable-semver-tag
agent_set:
primary: okf-function-environment-configs-researcher
paths:
- README.md
- package/crossplane.yaml
- fn.go
- fn_test.go
- input
- package/input
- examples
- go.mod
legacy_exclusions:
- examples requiring Claims or claim references
- examples requiring deprecated v1 XRD or legacy v1 XR semantics
- id: xprin
repository: crossplane-contrib/xprin
kind: composition-test-tool
- id: function-sequencer
repository: crossplane-contrib/function-sequencer
kind: function
audience: user
release_policy: discover-highest-stable-semver-tag
agent_set:
primary: okf-function-sequencer-researcher
paths:
- README.md
- package/crossplane.yaml
- package/input
- input
- fn.go
- fn_test.go
- main.go
- example
- examples
- go.mod
legacy_exclusions:
- examples requiring Claims or claim references
- examples requiring deprecated v1 XRD or legacy v1 XR semantics
- id: function-auto-ready
repository: crossplane-contrib/function-auto-ready
kind: function
audience: user
release_policy: discover-highest-stable-semver-tag
agent_set:
primary: okf-function-auto-ready-researcher
paths:
- README.md
- package/crossplane.yaml
- fn.go
- fn_test.go
- main.go
- features
- cel
- healthchecks
- input
- package/input/autoready.fn.crossplane.io_inputs.yaml
- example
- go.mod
legacy_exclusions:
- examples requiring Claims or claim references
- examples requiring deprecated v1 XRD or legacy v1 XR semantics
- id: provider-kubernetes
repository: crossplane-contrib/provider-kubernetes
kind: native-provider
- id: provider-sql
repository: crossplane-contrib/provider-sql
kind: native-provider
- id: provider-gitlab
repository: crossplane-contrib/provider-gitlab
kind: native-provider
- id: provider-helm
repository: crossplane-contrib/provider-helm
kind: native-provider
- id: provider-opentofu
repository: upbound/provider-opentofu
kind: native-provider
release_policy: discover-highest-stable-semver-tag
provider_family: bespoke-opentofu-workspace-provider
- id: function-patch-and-transform
repository: crossplane-contrib/function-patch-and-transform
kind: function
- id: provider-upjet-aws
repository: crossplane-contrib/provider-upjet-aws
kind: upjet-provider
terraform_source: terraform-provider-aws
release_policy: discover-highest-stable-semver-tag
provider_family: upjet-generated
supporting_sources:
- upjet
- terraform-provider-aws
family_provider_source:
package_metadata: package/crossplane.yaml.tmpl
resource_packages: docs/family
- id: provider-aws
repository: crossplane-contrib/provider-aws
kind: provider
release_policy: discover-highest-stable-semver-tag
provider_family: aws-go-codegen-with-manual-controller-work
related_provider: provider-upjet-aws
- id: provider-upjet-azure
repository: crossplane-contrib/provider-upjet-azure
kind: upjet-provider
terraform_source: terraform-provider-azurerm
- id: function-tag-manager
repository: crossplane-contrib/function-tag-manager
kind: function
audience: user
release_policy: discover-highest-stable-semver-tag
agent_set:
primary: okf-function-tag-manager-researcher
paths:
- README.md
- package/crossplane.yaml
- package/input/tag-manager.fn.crossplane.io_managedtags.yaml
- input
- fn.go
- fn_test.go
- filter.go
- filter_test.go
- filters
- tags.go
- tags_test.go
- main.go
- examples
- go.mod
- LICENSE
legacy_exclusions:
- examples requiring Claims or claim references
- examples requiring deprecated v1 XRD or legacy v1 XR semantics
documentation_sources:
- id: crossplane-cli-docs
repository: crossplane/docs
kind: official-documentation
domain: crossplane-cli
core_scope: false
agent: okf-crossplane-researcher
revision_policy: reuse-existing-lock
lock_id: crossplane-docs-v2.4
paths:
- content/cli/v2.4/get-started/get-started-with-control-plane-projects.md
- content/cli/v2.4/command-reference.md
focus:
- control-plane-projects
- composition-authoring
- local-development
- package-build-and-push
legacy_exclusions:
- Claims and claim workflows
- deprecated CompositeResourceDefinition v1 schema
- legacy v1 composite-resource semantics
version_scope: cli-v2.4
- id: crossplane-docs
repository: crossplane/docs
kind: official-documentation
agent: okf-crossplane-core-docs-researcher
release_policy: match-latest-stable-crossplane-major-minor
path_template: content/v{major}.{minor}
exclude_paths:
- content/master
- content/cli
- content/v1.*
focus:
- composition
- managed-resources
- operations
- packages/providers
- packages/functions
- release-cycle
- feature-lifecycle
legacy_exclusions:
- Claims and claim workflows
- v1 Composite Resources (Legacy)
- deprecated CompositeResourceDefinition v1 schema
- v1-to-v2 migration guidance unless explicitly requested
version_scope: current-stable-v2
historical_design_sources:
- id: crossplane-core-designs
repository: crossplane/crossplane
kind: historical-design
authority: historical-design
agent: okf-crossplane-core-design-researcher
revision_policy: pin-current-main-commit-at-research-time
paths:
- design
discovery: disabled
invocation: last-resort-for-specific-known-feature
requires_current_corroboration: true
cannot_define:
- current API shape
- runtime behavior
- supported workflow
- release inclusion
- feature maturity
- general feature inventory
supporting_sources:
- id: crossplane-build
repository: crossplane/build
kind: shared-build-tooling
authority: supporting
version_policy: exact-submodule-commit-from-selected-provider-template
paths:
- makelib/common.mk
- makelib/golang.mk
- makelib/k8s_tools.mk
- makelib/imagelight.mk
- makelib/xpkg.mk
- LICENSE
usage: version-matched build, test, image, and xpkg behavior invoked by provider-template
- id: function-kro-kro
repository: kubernetes-sigs/kro
kind: resource-graph-orchestrator-documentation
authority: supporting
version_policy: exact-version-from-selected-function-kro-go-mod
agent: okf-function-kro-kro-researcher
paths:
- website/docs
- LICENSE
usage: version-matched KRO ResourceGraphDefinition terminology and documented semantics; function-kro source remains authoritative for exposed behavior
- id: crd-catalog
repository: CustomResourceDefinition/catalog
kind: community-crd-schema-catalog
authority: supporting
usage: discovery of non-Crossplane CRD schema snapshots; never replace the installed operator CRD or imply Crossplane CLI integration
- id: upbound-package-api
url: https://api.upbound.io/v1/packages/
kind: provider-schema-registry
authority: official-registry
usage: rapid schema discovery; version-addressed routes preferred over latest
- id: upbound-marketplace
url: https://marketplace.upbound.io/
kind: provider-package-marketplace
authority: official-registry
usage: package identity, source metadata, and published support-capability metadata
- id: crossplane-provider-families-blog
url: https://blog.crossplane.io/crd-scaling-provider-families/
kind: historical-provider-context
authority: historical-context
published_at: 2023-06-13
usage: historical-rationale-only; corroborate-current-behavior-with-released-provider-source
- id: argo-cd
repository: argoproj/argo-cd
kind: gitops-controller
authority: supporting
release_policy: requested-stable-minor-release
paths:
- resource_customizations
- util/lua
- docs/operator-manual/health.md
- id: cli-utils-kstatus
repository: kubernetes-sigs/cli-utils
kind: kubernetes-status-library
authority: supporting
paths:
- pkg/kstatus/status
- id: flux-website
repository: fluxcd/website
kind: official-flux-documentation
authority: supporting
release_policy: requested-minor-release-track
paths:
- content/en/flux/cheatsheets/cel-healthchecks.md
- id: sprig
repository: Masterminds/sprig
kind: template-function-library
authority: supporting
version_policy: exact-version-from-selected-function-go-templating-go-mod
agent: okf-function-go-templating-sprig-researcher
paths:
- README.md
- docs
availability_source: function-go-templating/function_maps.go
- id: upjet
repository: crossplane/upjet
kind: upjet-framework
- id: terraform-provider-aws
repository: hashicorp/terraform-provider-aws
kind: terraform-provider
documentation: https://registry.terraform.io/providers/hashicorp/aws/latest/docs
- id: terraform-provider-azurerm
repository: hashicorp/terraform-provider-azurerm
kind: terraform-provider
documentation: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs
- id: external-secrets
repository: external-secrets/external-secrets
kind: kubernetes-secrets-operator
authority: supporting
release_policy: user-requested-stable-tag
paths:
- docs/api/pushsecret.md
- docs/guides/pushsecrets.md
- docs/snippets/vault-pushsecret.yaml
- docs/snippets/aws-sm-push-secret-with-metadata.yaml
- apis/externalsecrets/v1alpha1/pushsecret_types.go
- config/crds/bases/external-secrets.io_pushsecrets.yaml
- LICENSE
usage: platform secret-publication pattern; not evidence of Crossplane behavior
project_history_sources:
- id: argo-cd-project-history
repository: argoproj/argo-cd
kind: github-issues-and-pull-requests
authority: project-history
author_policy: humans-only
exclude_authors:
- bots
- apps
- dependabot
- renovate
- github-actions
- release-automation
usage: bounded supporting-tool release provenance
- id: crossplane-project-history
repository: crossplane/crossplane
kind: github-issues-and-pull-requests
authority: project-history
author_policy: humans-only
exclude_authors:
- bots
- apps
- dependabot
- renovate
- github-actions
- release-automation
usage: bounded reports that are corroborated by selected-release evidence
- id: function-sequencer-project-history
repository: crossplane-contrib/function-sequencer
kind: github-issues-and-pull-requests
authority: project-history
author_policy: humans-only
exclude_authors:
- bots
- apps
- dependabot
- renovate
- github-actions
- release-automation
usage: bounded supporting reports for related Core limitations
- id: function-go-templating-project-history
repository: crossplane-contrib/function-go-templating
kind: github-issues-and-pull-requests
authority: project-history
agent: okf-function-go-templating-project-history-researcher
author_policy: humans-only
exclude_authors:
- bots
- apps
- dependabot
- renovate
- github-actions
- release-automation
windows:
release_changes: previous-stable-tag-to-selected-stable-tag
known_reports: open-items-relevant-to-selected-stable-tag
post_release: created-or-updated-after-selected-stable-tag
usage: summarize-by-user-facing-theme
example_sources:
- id: sveltos-addon-controller
repository: projectsveltos/addon-controller
kind: kubernetes-addon-controller
origin: third-party
authority: illustrative
release_policy: discover-highest-stable-semver-tag
paths:
- api/v1beta1/clustersummary_types.go
- controllers/profile_utils.go
- controllers/utils.go
- lib/clusterops/clustersummary.go
- LICENSE
usage: summarize-and-cite
- id: sveltos-libsveltos
repository: projectsveltos/libsveltos
kind: kubernetes-api-library
origin: third-party
authority: illustrative
release_policy: match-sveltos-addon-controller
paths:
- api/v1beta1/common_types.go
- LICENSE
usage: summarize-and-cite
- id: kubernetes-reflector
repository: emberstack/kubernetes-reflector
kind: kubernetes-resource-replication-controller
origin: third-party
authority: illustrative
paths:
- README.md
- src/ES.Kubernetes.Reflector/Mirroring
- src/helm/reflector/templates/clusterRole.yaml
- LICENSE
usage: summarize-and-cite
- id: kubernetes-replicator
repository: mittwald/kubernetes-replicator
kind: kubernetes-resource-replication-controller
origin: third-party
authority: illustrative
paths:
- README.md
- main.go
- replicate
- deploy/helm-chart/kubernetes-replicator
- LICENSE.txt
usage: summarize-and-cite
- id: homelab-idp-crossplane-compositions
repository: 0xayf/homelab-idp
kind: crossplane-compositions
origin: third-party
authority: illustrative
paths:
- platform-core/controlplane/crossplane-compositions
usage: summarize-and-cite
source_policy:
pin_commits: true
prefer_primary_sources: true
allow_unpinned_citations: false
allow_name_only_upjet_mapping: false
historical_design_can_discover_features: false
historical_design_can_define_current_facts: false
historical_design_requires_current_corroboration: true
historical_design_can_define_feature_state: false
third_party_examples_can_define_behavior: false
third_party_examples_require_corroboration: true
verify_license_before_copying: true
resolve_current_stable_release_before_core_research: true
resolve_current_stable_release_before_function_research: true
stable_release_definition: highest-semver-tag-excluding-draft-prerelease-rc-beta-alpha
allow_function_main_fallback: false
infer_feature_state_from_api_version: false
exclude_legacy_claims: true
exclude_deprecated_xrd_v1: true
treat_all_v1_api_versions_as_legacy: false
require_dedicated_agent_set_per_function: true
project_history_requires_research_timestamp: true
project_history_excludes_bots_and_apps: true
project_history_can_define_released_behavior: false
merged_pr_requires_release_commit_containment: true
closed_issue_implies_fixed: false
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |