GraphQL type catalog
Every real function, type, enum, and operation kind from the style-graphql skill, grouped by category unless filtered.
projection functions
extractCitations
extractCitations(doc: GraphQLDoc): Citation[]
Extracts Citation-typed values out of a parsed GraphQLDoc.
SKILL.md, "Projection contract" section, style-graphql skill.
injectCitationType
injectCitationType(doc: GraphQLDoc): GraphQLDoc
Appends the canonical Citation SDL (from references/citation.graphqls) to a document if not already present.
SKILL.md, "Projection contract" and "Citation type SDL" sections, style-graphql skill.
injectCitations
injectCitations(doc: GraphQLDoc, cs: Citation[]): GraphQLDoc
Injects a list of Citation values into a GraphQLDoc.
SKILL.md, "Projection contract" section, style-graphql skill.
parse
parse(wire: string, kind?: GraphQLKind): GraphQLDoc
Parses a raw SDL or operation string into a GraphQLDoc AST, optionally tagged with a GraphQLKind.
SKILL.md, "Projection contract" section, style-graphql skill.
roundtrip
roundtrip(doc: GraphQLDoc): GraphQLDoc
Parses then stringifies a document; used in tests to assert idempotence of the print step.
SKILL.md, "Projection contract" and "Normalisation" sections, style-graphql skill.
stringify
stringify(doc: GraphQLDoc): string
Serializes a GraphQLDoc back to canonical SDL text, normalised via graphql-js print().
SKILL.md, "Projection contract" and "Normalisation" sections, style-graphql skill.
types
AnthropicCitationBridge
type AnthropicCitationBridge {
documentIndex: Int
documentTitle: String
startCharIndex: Int
endCharIndex: Int
citedText: String
}
Bridge fields mapping the Citation type onto the Anthropic Citations API response shape (document index/title, character span, verbatim cited text).
references/citation.graphqls (style-graphql skill), lines 83-96, citing docs.anthropic.com/en/docs/build-with-claude/citations.
Citation
type Citation {
id: ID!
type: CSLType!
title: String!
author: [CSLName!]
issued: CSLDate
containerTitle: String
publisher: String
url: String
doi: String
anthropic: AnthropicCitationBridge
prov: ProvO
}
The canonical Citation GraphQL type: a strict subset of CSL-JSON v1.0.2, maps 1:1 to the Citation Zod schema (src/style-skills/citation.schema.ts). Injected into any SDL document by injectCitationType(doc).
references/citation.graphqls (style-graphql skill), lines 1-43; also summarized in SKILL.md Citation type SDL section.
CSLDate
type CSLDate {
dateParts: [[Int]]
literal: String
}
Publication date shape used by Citation.issued. dateParts is a nested array of [year, month?, day?]; literal is free text when date-parts are unavailable.
references/citation.graphqls (style-graphql skill), lines 52-57.
CSLName
type CSLName {
family: String
given: String
literal: String
}
Author name shape used by Citation.author. literal is for institutional or single-name authors.
references/citation.graphqls (style-graphql skill), lines 45-50.
Provenance
type Provenance {
source: ProvenanceSource!
schemaRef: String
agentId: String
freshness: String
reviewer: String
reviewerPassed: Boolean
citations: [Citation!]!
}
Provenance footer type appended to every style-skill output; mirrors the pattern from an Anthropic self-service analytics blog post. Note: SKILL.md own Provenance in GraphQL responses example shows a simpler 5-field Provenance shape (source, agentId, schemaRef, freshness, reviewer as String!) for query results -- the bundled references/citation.graphqls file defines a richer 7-field version with a ProvenanceSource enum and reviewerPassed/citations fields. Both are real, from two different places in the skill; this row documents the references/citation.graphqls version.
references/citation.graphqls (style-graphql skill), lines 111-123.
ProvO
type ProvO {
wasDerivedFrom: [String!]
generatedAtTime: String
wasAttributedTo: String
}
W3C PROV-O provenance fragment: wasDerivedFrom (source entity IRIs), generatedAtTime (ISO-8601), wasAttributedTo (agent IRI).
references/citation.graphqls (style-graphql skill), lines 98-109, citing w3.org/TR/prov-o/.
QueryResult
type QueryResult {
data: String!
citations: [Citation!]!
provenance: Provenance!
}
Example root type shape shown in SKILL.md for a GraphQL response that contains cited content: add a provenance field to the root Query or relevant type.
SKILL.md, Provenance in GraphQL responses section, style-graphql skill.
enums
CSLType
enum CSLType {
ARTICLE_JOURNAL
ARTICLE_MAGAZINE
ARTICLE_NEWSPAPER
BOOK
CHAPTER
DATASET
DOCUMENT
MANUSCRIPT
PAPER_CONFERENCE
POST_WEBLOG
REPORT
SOFTWARE
SPEECH
STANDARD
THESIS
TREATY
WEBPAGE
}
CSL type enum: a 17-member subset covering the most common citation types, out of the full CSL v1.0.2 specification (46 types per docs.citationstyles.org).
references/citation.graphqls (style-graphql skill), lines 59-81.
ProvenanceSource
enum ProvenanceSource {
SEMANTIC_LAYER
GOVERNED_TABLE
RAW_EXPLORATION
SKILL_REFERENCE
EXTERNAL_URL
}
Enum for the Provenance.source field -- where a cited value in a GraphQL response actually came from.
references/citation.graphqls (style-graphql skill), lines 125-131.
operation kinds
mutation
GraphQLKind: mutation operation.
SKILL.md, "kinds" section, style-graphql skill.
query
GraphQLKind: query operation.
SKILL.md, "kinds" section, style-graphql skill.
sdl
GraphQLKind: schema definition language -- type definitions, directives.
SKILL.md, "kinds" section, style-graphql skill.
subscription
GraphQLKind: subscription operation.
SKILL.md, "kinds" section, style-graphql skill.
Machine-readable version: GET /api/graphql-types