Skip to content
Skills Library
Programming · Review & audit

googlecloudplatform-knowledge-catalog

/googlecloudplatform-knowledge-catalog

Use this skill when interacting with the knowledge-catalog repository to ensure all modifications strictly adhere to the Open Knowledge Format (OKF) specification.

Author
jmxt3 ↗
Repository
gitscape.ai ↗
Licence
Apache-2.0
Last repository change
17.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
12
Scripts
2
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 17.07.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 2 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: exporters/googlecloudplatform_knowledge_catalog_adk_skill.py, exporters/googlecloudplatform_knowledge_catalog_agno_skill.py

What it does and when to use it

Use this skill when interacting with the knowledge-catalog repository to ensure all modifications strictly adhere to the Open Knowledge Format (OKF) specification.

Original author description

Use this skill when interacting with the knowledge-catalog repository to ensure all modifications strictly adhere to the Open Knowledge Format (OKF) specification.

How it works

  1. Overview
  2. When to Use
  3. Core Process
  4. Common Rationalizations
  5. Red Flags
  6. Verification
  7. Code Access
Original SKILL.md headings · 72 lines, 565 words
SKILL.md preview
---
name: googlecloudplatform-knowledge-catalog
description: "Use this skill when interacting with the knowledge-catalog repository to ensure all modifications strictly adhere to the Open Knowledge Format (OKF) specification."
---

# GoogleCloudPlatform/knowledge-catalog — Engineering Skill

## Overview

The knowledge-catalog repository defines the Open Knowledge Format (OKF), a vendor-neutral standard for representing knowledge. This codebase provides the reference implementation for producing and validating these bundles. It is critical to understand that the format is the primary product; the agents and runners are secondary tools meant to demonstrate how to produce and enrich these bundles.

Before modifying any code, you must ensure you are not coupling the OKF structure to specific model providers or frameworks. The system relies on a clear mapping between file system paths and concept IDs. Any changes to the ingestion or enrichment logic must preserve the ability for third-party tools to parse these files without dependency on this repository's internal agent logic.

## When to Use

- Implementing custom logic to generate OKF bundles
- Extending the ReferenceRunner to support new data sources
- Updating the validation logic for OKFDocument
- Regenerating indexes for existing knowledge bundles
- Adding new enrichment strategies via synthesize_description

**When NOT to use:** Do not use this skill for tasks that introduce vendor-specific dependencies or deviate from the plain-text markdown/YAML structure defined in SPEC.md.

## Core Process

### Step 1: Validate against OKF Specification

Before writing code, verify that your proposed change complies with SPEC.md. Use the OKFDocument.validate() method to ensure your document structure remains compliant with the format requirements.

### Step 2: Maintain Path-Concept Mapping

Always use path_to_concept_id and concept_id_to_path when navigating the bundle structure. This ensures that the file system hierarchy remains consistent with the conceptual graph of the knowledge base.

### Step 3: Enrich with ReferenceRunner

When adding new knowledge, utilize the ReferenceRunner.enrich_concept method. This ensures that enrichment follows the established pipeline, using the configured model to synthesize descriptions while maintaining the integrity of the existing bundle.

## Common Rationalizations

| Rationalization | Reality |
|---|---|
| I will store metadata in a custom JSON sidecar file. | OKF requires all metadata to be in the YAML frontmatter of the markdown file to remain vendor-neutral. |
| I can hardcode paths to simplify the logic. | Hardcoded paths break the portability of the bundle; always use the provided path-to-concept helpers. |
| I will use a proprietary database to store the index. | The index must be regeneratable from the file system using regenerate_indexes to ensure the format remains self-contained. |

## Red Flags

- Hardcoding file paths instead of using path-to-concept helpers
- Introducing dependencies on non-standard cloud services
- Modifying OKFDocument serialization without updating the validator
- Ignoring the SPEC.md requirements for frontmatter
- Bypassing the ReferenceRunner when enriching concepts

## Verification

- [ ] Run OKFDocument.validate() on all modified documents
- [ ] Verify path-to-concept consistency using the provided helpers
- [ ] Ensure no new external dependencies were added to pyproject.toml
- [ ] Check that all generated markdown files contain valid YAML frontmatter
- [ ] Confirm that regenerate_indexes completes without errors
- [ ] Verify that the change does not break the visualizer's ability to parse the bundle

## Code Access

The full source digest for this repository is available locally:

- [Full Code Digest](googlecloudplatform_knowledge_catalog_digest.txt)

The full source digest for **GoogleCloudPlatform/knowledge-catalog** is also available via the GitScape API:

```
GET https://gitscape.ai/api/converter?repo_url=https://github.com/GoogleCloudPlatform/knowledge-catalog
```

Load the `digest` field from the response into your context for complete source-code access. You can also visit [gitscape.ai](https://gitscape.ai/?repo=https%3A%2F%2Fgithub.com%2FGoogleCloudPlatform%2Fknowledge-catalog) and download the Code Digest from the site.
Files in this package (12)
  • SKILL.md 4 KB
  • googlecloudplatform_knowledge_catalog_digest.txt 821 KB
  • manifest.json 2 KB
  • scan-report.json 2 KB
  • scan-report.sarif 34 KB
  • exporters/googlecloudplatform_knowledge_catalog_adk_skill.py 2 KB
  • exporters/googlecloudplatform_knowledge_catalog_agno_skill.py 1 KB
  • references/api.md 23 KB
  • references/architecture.md 6 KB
  • references/config.md 1 KB
  • references/examples.md 5 KB
  • references/setup.md 1 KB

Versions

The database has no other skills named googlecloudplatform-knowledge-catalog.

Database snapshot: 13.11.2026 · package version 46c63701b1a6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95knowledge-catalog
    Work with GoogleCloudPlatform/knowledge-catalog, a repository of Google Cloud Knowledge Catalog samples, agents, and tools. Use when inspecting its OKF reference-agent, mdcode/kcmd semantic-model catalog workflows, sample enrichment/governance agents, or their deployment and…
  • 100okf-wiki
    Builds an Open Knowledge Format (OKF) knowledge base from existing docs, notes, or a repo. Use to scaffold an OKF wiki.
  • 95okf-authoring
    Author Open Knowledge Format (OKF) bundles — knowledge represented as a directory of markdown files with YAML frontmatter. Use when asked to create, write, generate, enrich, or validate an OKF bundle or OKF concept docs; to turn a data source (Glue database, API, database,…
  • 95okf-open-knowledge-format
    Create, validate, and enrich Open Knowledge Format (OKF) bundles — the open spec for representing organizational knowledge as markdown files with YAML frontmatter. Use when the user mentions 'OKF', 'Open Knowledge Format', 'knowledge bundle', 'OKF bundle', 'create a knowledge…
  • 100open-knowledge-format
    Define knowledge bundles with Google's Open Knowledge Format (OKF) v0.1. Use when the user mentions OKF, Open Knowledge Format, Google's knowledge format, LLM wiki bundles, agent knowledge packs, creating OKF bundles, validating OKF documents, or converting knowledge into the…
  • 100okf-ops
    Assess, validate, and adopt the Open Knowledge Format (OKF) across markdown+frontmatter knowledge bases. Triggers on: OKF, open knowledge format, knowledge bundle, frontmatter conformance, validate frontmatter, markdown knowledge base, adopt OKF, is this repo OKF-ready, index.md log.md.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.