Knowledge Graph Registry Curator

This skill helps you curate and expand metadata for knowledge graphs in the Knowledge Graph Registry project, following the established schema and curation workflow.

What This Skill Does

Guides you through adding and updating knowledge graph resources and products according to the KG-Registry schema and best practices. Enforces data quality rules, schema compliance, and automated generation workflows.

Instructions

Core Principles

1. **Always follow the schema** defined in `src/kg_registry/kg_registry_schema/schema/kg_registry_schema.yaml`

2. **Use existing enums only** - never create new values for enum fields

3. **Use existing categories only** - never create new category classes

4. **Never modify the `registry` directory** - these files are auto-generated

5. **Never create Product files manually** - they are auto-generated from Resource entries

Resource Entry Guidelines

When creating or updating Resource entries:

- Example: "A mapping file to WikiPathways" → include `wikipathways` in `original_source`

Product Entry Guidelines

Date and Metadata Fields

Validation Workflow

Before committing any changes:

```bash

Validate a specific file

poetry run make validate-file FILE=resource/your-resource.yaml

Validate all resources

poetry run make validate

```

Quick Curation Workflow

1. **Find stub pages**: Look for Resources with `stub` in their `domains` list

2. **Select a candidate**: Choose a random stub page

- Check `reports/curation_problems.tsv` first

- Skip if already logged, select another

3. **Research the Resource**:

- Start with `homepage_url` if present

- Conduct literature search if needed

- Gather accurate metadata

4. **Expand the Resource page**:

- Consult schema and existing pages as examples

- Add Products (definitions only, not separate files)

- Preserve existing Products (may be referenced by other Resources)

- If curation blockers encountered, log in `reports/curation_problems.tsv` and move on

5. **Validate**:

- Run `poetry run make validate-file FILE=resource/your-file.yaml`

- Fix all validation errors before proceeding

6. **Repeat**: Curate at least 5 Resources per session

Common Pitfalls to Avoid

File Organization

```

resource/ # Manually created/updated Resource entries

registry/ # Auto-generated (DO NOT EDIT)

reports/ # Curation tracking and problem logs

src/ # Schema definitions

```

Example Resource Entry Structure

```yaml

id: example-kg

label: Example Knowledge Graph

description: A brief description of this knowledge graph

homepage_url: https://example.org

domains:

- biomedical

# Remove 'stub' when expanding

categories:

- KnowledgeGraph

products:

- id: example-kg-nodes

label: Example KG Nodes

description: Node file for Example KG

category: Product

original_source:

- example-kg

creation_date: "2026-02-01"

last_modified_date: "2026-02-01"

```

Validation Commands

```bash

Validate single file

poetry run make validate-file FILE=resource/my-resource.yaml

Validate all resources

poetry run make validate

Generate products (auto-creates Product pages)

poetry run make generate-products

```

Notes