harvard-artifacts-collection-analytics-pipeline — Claude Code skill
A skill that walks your agent through a full Harvard Art Museums API pipeline: ETL, SQL storage and a Streamlit dashboard.
npx skills add reason-machines/data-skills --skill harvard-artifacts-collection-analytics-pipeline -a claude-codeWhat harvard-artifacts-collection-analytics-pipeline does
The skill drives a project along one path: API → ETL → SQL → analytics → visualization. You supply a Harvard Art Museums API key, and the agent writes the extraction code, reshapes the JSON into metadata, media and color tables, then loads them into MySQL or TiDB Cloud. Three tables carry the data — artifactmetadata, artifactmedia, artifactcolors — joined on artifact_id.
Inside are Python building blocks: requests with a pause between pages so the API rate limit does not bite, pandas for the transform, mysql-connector-python for the connection, plus plotly and streamlit for the dashboard. Fetching is paginated and limited to objects that have images.
Before anything runs you need a .env file with HARVARD_API_KEY and the database settings: DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME. No working MySQL or TiDB Cloud connection means the pipeline stalls at the load step, because there is nowhere to write the tables. Dependencies come from requirements.txt.
What it helps with
- pull artifact metadata from the Harvard Art Museums API page by page
- split nested JSON into metadata, media and color tables
- load the transformed rows into MySQL or TiDB Cloud
- write analytical SQL over the collection
- build an interactive Streamlit dashboard with Plotly charts
Example prompts for the agent
- build an ETL pipeline for the Harvard Art Museums API: extract, transform and load into MySQL
- add SQL queries to analyze the collection by culture and technique
- create a Streamlit dashboard visualizing colors and departments
How to install harvard-artifacts-collection-analytics-pipeline
1Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill harvard-artifacts-collection-analytics-pipeline -a claude-code2Manually: put the files in place
~/.claude/skills/harvard-artifacts-collection-analytics-pipeline/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/harvard-artifacts-collection-analytics-pipeline/
1Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill harvard-artifacts-collection-analytics-pipeline -a codex2Manually: put the files in place
.agents/skills/harvard-artifacts-collection-analytics-pipeline/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill harvard-artifacts-collection-analytics-pipeline -a cursor2Manually: put the files in place
.cursor/skills/harvard-artifacts-collection-analytics-pipeline/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/data-skills harvard-artifacts-collection-analytics-pipeline2Manually: put the files in place
.github/skills/harvard-artifacts-collection-analytics-pipeline/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill harvard-artifacts-collection-analytics-pipeline -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/data-skills --path skills/harvard-artifacts-collection-analytics-pipelineManually: put the files in place
.devin/skills/harvard-artifacts-collection-analytics-pipeline/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill harvard-artifacts-collection-analytics-pipeline -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about harvard-artifacts-collection-analytics-pipeline
How do I install harvard-artifacts-collection-analytics-pipeline in Claude?
Run npx skills add reason-machines/data-skills --skill harvard-artifacts-collection-analytics-pipeline -a claude-code. The skill lands at ~/.claude/skills/harvard-artifacts-collection-analytics-pipeline/SKILL.md.
What does this skill do?
It takes the agent through the whole Harvard Art Museums data cycle: fetching objects from the API, reshaping JSON into tables, loading them into a SQL database and building a Streamlit dashboard.
What do I need before running it?
A HARVARD_API_KEY and access to MySQL or TiDB Cloud — host, port, user, password and database name in .env. Dependencies install from requirements.txt.