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/sources.yaml

View on GitHub
version: 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
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