Skip to content

feat: add GraphQL skill for ARIA API exploration #149

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Draft
vredchenko wants to merge 3 commits into
base: main
Choose a base branch
from
Draft

feat: add GraphQL skill for ARIA API exploration #149

vredchenko wants to merge 3 commits into from

Conversation

@vredchenko
Copy link
Collaborator

@vredchenko vredchenko commented Jan 29, 2026 •
edited
Loading

Summary

  • Add graphqurl-based skill to support fandanGO connector development
  • Enable ARIA GraphQL API exploration from the command line
  • Document decision in ADR-0015

Changes

  • ADR-0015: Document decision to add graphqurl for ARIA GraphQL work
  • Skill: Create claude-code/fandango-cryoem-dls/skills/graphql/ with:
    • SKILL.md - Manifest and documentation
    • package.json - graphqurl dependency
    • run.js - Universal executor
    • lib/helpers.js - ARIA-specific utilities (auth, query templates)
  • Config: Register skill in claude-code-config.json
  • Dev requirements: Add graphqurl as optional tool

Features

  • Dual endpoint support: aria-mock (localhost:9002) and ARIA beta (graphql-beta.aria.services)
  • OAuth2 authentication with Keycloak at auth.aria.services
    • Auto-detection of grant type based on environment variables
    • Support for public clients (password grant without client_secret)
    • Configurable scope (defaults to 'openid')
  • Pre-built query templates for buckets, records, fields, visits
  • Schema introspection via --introspect flag
  • File or inline query execution

Test plan

  • Run npm install in skill directory
  • Test node run.js --help shows usage
  • Test node run.js --introspect against aria-mock
  • Verify skill appears when running /graphql in Claude Code
  • Test authentication against ARIA beta with user credentials

@vredchenko
feat: add GraphQL skill for ARIA API exploration
a9b45fa 
Add graphqurl-based skill to support fandanGO connector development
and ARIA GraphQL API exploration from the command line.

- Add ADR-0015 documenting GraphQL CLI tooling decision
- Create skill at claude-code/fandango-cryoem-dls/skills/graphql/
- Support aria-mock and ARIA beta endpoints
- Include OAuth2 authentication helpers for Keycloak
- Add common query templates for buckets, records, fields
- Register skill in claude-code-config.json
- Add graphqurl to optional dev requirements
@github-actions github-actions bot added documentation Improvements or additions to project documentation smartem-devtools:claude Claude Code configuration, skills, and prompts labels Jan 29, 2026
@vredchenko
chore: add package-lock.json for graphql skill
5942327
@vredchenko
fix: update ARIA GraphQL skill for new API endpoints
6ec82f8 
- Update beta endpoint to graphql-beta.aria.services
- Update Keycloak URL to auth.aria.services
- Add auto-detection of OAuth2 grant type based on env vars
- Support public clients (no client_secret for password grant)
- Add scope parameter support (defaults to 'openid')
- Update documentation with correct URLs and auth examples
- Use npx for gq to avoid path resolution issues
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

documentation Improvements or additions to project documentation smartem-devtools:claude Claude Code configuration, skills, and prompts

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@vredchenko