Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/hecatehq/hecatenpx agentmods add skills/hecatehq/hecate/providersWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/hecatehq/hecate/providers)<a href="https://agentmods.dev/skills/hecatehq/hecate/providers"><img src="https://agentmods.dev/badge/skills/hecatehq/hecate/providers.svg" alt="Measured on agentmods" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00055 | $0.02411 |
| Opus 5 | $0.00028 | $0.01205 |
| Sonnet 5 | $0.00011 | $0.00482 |
| Haiku 4.5 | $0.00006 | $0.00241 |
Grade A, and why
hecate-providers scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 128 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Hecate providers skill
Use this skill for work in internal/providers/ and any change that crosses the api↔providers boundary. Backend-wide rules are in ../backend/SKILL.md; field-shape rules in ../../core/engineering-standards.md; the race-suite floor in ../../core/verification.md.
Layout
provider.go Provider / Streamer / Capabilities interfaces
openai.go OpenAI-compat adapter (real OpenAI, Together, Groq, Ollama, vLLM)
openai_transcription.go Explicit OpenAI-compatible audio transcription adapter
anthropic.go Native Anthropic Messages API adapter
runtime_manager.go provider catalog + protocol → adapter dispatch
capabilities_cache.go /v1/models discovery + TTL cache
discovery_policy.go when to discover, when to use static caps
health.go provider health probe + circuit
mutable_registry.go control-plane mutation surface
Test helpers live in provider_test_helpers_test.go and tooluse_test.go (the newAnthropicTestProvider helper is there, not in anthropic_test.go).
The capital/lowercase parallel-struct rule
internal/api/openai.go defines OpenAIChatMessage, OpenAIMessageContent, OpenAIContentBlock (capital).
This package defines openAIChatMessage, openAIMessageContent, openAIContentBlock (lowercase).
Same JSON shape, two packages, intentional. Keeps internal/providers/ free of internal/api/ imports — the wire shapes evolve independently. When you add a field on one side, mirror it on the other.
The polymorphic content type (UnmarshalJSON / MarshalJSON for string-or-array-or-null) is duplicated for the same reason. Don't try to share — the duplication is the contract. Sharing would re-introduce the import.
The seven-step chain
Adding a passthrough wire field. This is the most-redone task in the providers package; the chain is canonical and lives here.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 8d ago First seen · 128 lines · 55 tokens per session scan A 430ed50ceb37
hecate-providers is a skill published in the GitHub repository hecatehq/hecate (22 stars, last pushed today), licensed MIT. It adds 55 tokens to every session and 2,411 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
go-expert
Expert-level Go development with Go 1.22+ features, concurrency, standard library, and production-grade best practices. Use when the user mentions concurrency, microservices, or backend, or when the task involves idiomatic Go, goroutines and channels, context-based cancellation, or writing an HTTP server.
go-context
Use when working with context.Context in Go — placement in signatures, propagating cancellation and deadlines, and storing values in context vs parameters. Also use when cancelling long-running operations, setting timeouts, or passing request-scoped data, even if they don't mention context.Context directly. Does not…
go-functional-options
Use when designing a Go constructor or factory function with optional configuration — especially with 3+ optional parameters or extensible APIs. Also use when building a New function that takes many settings, even if they don't mention "functional options" by name. Does not cover general function design (see…
pn-go-scaffolding
Scaffolds new Go API projects (Gin, Fiber, Echo, Chi) or handlers. Use when adding a new route/module; covers idiomatic project layout, env/secrets, error handling, and Go-specific conventions.
golang-graphql
Implements GraphQL APIs in Golang using gqlgen or graphql-go. Apply when building GraphQL servers, designing schemas, writing resolvers, handling subscriptions, or integrating GraphQL with existing Go HTTP services. Also apply when the codebase imports github.com/99designs/gqlgen or github.com/graph-gophers/graphql-go.
golang-grpc
Provides gRPC usage guidelines, protobuf organization, and production-ready patterns for Golang microservices. Use when implementing, reviewing, or debugging gRPC servers/clients, writing proto files, setting up interceptors, handling gRPC errors with status codes, configuring TLS/mTLS, testing with bufconn, or…