Your Domain Name Skill

Use this skill to [describe primary use case]. Claude acts as [describe Claude's role in this domain].

When to use: [Triggers: "ingest [item]", "analyze [item]", "show [entity]", ...]

Prerequisites

• TypeDB must be running: make db-start
• Dependencies installed: uv sync --all-extras (from project root)
• Schema loaded: run make build-db after adding your schema.tql

Environment Variables

• TYPEDB_HOST: TypeDB server (default: localhost)
• TYPEDB_PORT: TypeDB port (default: 1729)
• TYPEDB_DATABASE: Database name (default: alhazen_notebook)

Quick Start

uv run python .claude/skills/<your-domain>/<your-domain>.py list-entities

Schema Gap Recognition

During sensemaking, if you encounter a concept, relationship, or entity type that has no place in the current TypeDB schema, that is a schema gap — a signal for schema evolution, not a failure.

When you notice a schema gap:

1. Complete as much as possible with the current schema (partial knowledge > none)
2. Immediately file a gap issue:

gh issue create --repo <owner/name> \
  --title "Gap [moderate][entity-schema]: <one-sentence summary>" \
  --body $'## What was missing\n<the concept you tried to represent>\n\n## What broke\n<which TypeDB entity/relation/attribute is absent>\n\n## Suggested fix\n<proposed TypeQL addition, or unknown>' \
  --label "gap:open"

Examples of schema gaps:

• A paper has a methodology section but there's no methodology attribute on scilit-paper
• A job posting mentions a work arrangement type that isn't in the schema
• A disease has a phenotype frequency that can't be attached to the current relation

Use --dry-run first to review the issue before filing it.

Command Output Pattern

uv run emits a VIRTUAL_ENV warning to stderr. Always use 2>/dev/null when piping output to a JSON parser — never 2>&1, which merges the warning into stdout and breaks JSON parsing.

Before executing any commands, read USAGE.md in this directory for the complete command reference, workflows, and data model.