Goldsmith (GO-Linked-Data-Smithery)

Tiny, specialized Claude Code skills for Gene Ontology curators. Create, validate, and submit GO-CAM annotations from the terminal.

Quick Start

git clone <this-repo>
cd goldsmith
bash setup.sh

Setup will install dependencies, configure your environment, and launch Claude Code. Then try your first annotation:

/go-try annotate that human TP53 has protein kinase binding activity from PMID:20154695

Skills

Skill	What it does
/go-try	Create GO-CAM annotations from natural language descriptions
/go-validate	Validate annotation files against the gocam-py/LinkML schema
/go-check	Run QC checks beyond schema validation (term existence, taxon, evidence)
/go-pr	Submit your annotations as a GitHub Pull Request

Prerequisites

• Python 3.10+
• Node.js (for Claude CLI)
• A Google Cloud service account key for Vertex AI (see setup/README.md)

Manual Setup

If you prefer not to use setup.sh:

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
mkdir -p output

Documentation

make serve    # Local docs at http://localhost:8000

Full documentation: goldsmith docs site

Development

make setup    # Run setup.sh
make docs     # Build docs
make serve    # Serve docs locally
make deploy   # Deploy docs to GitHub Pages
make clean    # Remove build artifacts