Skip to content

feat(skill): add the oae-metadata skill for drafting metadata with an AI assistant - #60

Open
clevinson wants to merge 12 commits into
mainfrom
feat/oae-metadata-skill
Open

clevinson wants to merge 12 commits into
mainfrom
feat/oae-metadata-skill

Conversation

@clevinson

Copy link
Copy Markdown
Member

Adds skills/oae-metadata: a skill that has an AI assistant draft a metadata JSON plus a report of gaps and uncertain values from a researcher's documents and data files, for import into the Metadata Builder.

  • SKILL.md and four hand-written references (class choice, Builder import rules, report template, OAPMetadata XML mapping).
  • scripts/validate.py: standard-library validator that reports structural errors separately from gaps and prints each bounding box in words.
  • Generated reference files (one per class, labelled vocabularies), built by just gen-all and covered by the CI drift check.
  • The docs build now publishes each page's markdown beside its HTML, /llms.txt, and the skill at /skill/. New docs page: Drafting Metadata with an AI Assistant.
  • skills/README.md replaces the architecture proposal from docs: add architecture proposal for skills & plugin development #42.

Evals use third-party documents and stay outside the repo. On Claude Sonnet, across five cases, drafts made with only the JSON Schema validated but filled required fields with invented values in every run; drafts made with the skill had no structural errors and no invented values.

@github-actions

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.2

QR code for preview link

🚀 View preview at
https://submarine-mrv.github.io/oae-data-protocol/pr-preview/pr-60/

Built to branch gh-pages at 2026-11-11 16:34 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant