Imported from smartcontractkit/chainlink-ccv (AGENTS.md). Install upstream with npx skills add smartcontractkit/chainlink-ccv. Copyright stays with the author.

AGENTS.md

Name: chainlink-ccv
Author: smartcontractkit

Guidance for AI agents working in this repository. Read CONTRIBUTING.md for PR title and merge mechanics. This file records conventions that are easy to get wrong by pattern-matching against older code that predates them.

Credentials: secrets file, not environment variables

New credentials are read from the service's secrets file only. Do not add an environment variable for one.

The VERIFIER_AGGREGATOR_* env vars and CL_DATABASE_URL exist only for backwards compatibility with deployments that predate the secrets file. A credential introduced after the file has no such history, so it gets no env var and there is exactly one place an operator has to look. The policy-hook HMAC pair is the model: verifier/pkg/policy/auth.go resolves it from the secrets file's [policy_hook] table and nowhere else, and a half-supplied pair is a startup error rather than a silent downgrade to no authentication.

Related: configuration that is marshaled into a Job Distributor job spec (for example the verifier's [policy_hook] TOML section) must never carry a credential value, because the spec is stored in JD. Reference where the secret lives; keep the value in the secrets file.

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

{ "ocm": "1", "id": "smartcontractkit-chainlink-ccv-chainlink-ccv", "kind": "skill", "name": "chainlink-ccv", "description": "Guidance for AI agents working in this repository. Read CONTRIBUTING.md for PR title and merge mechanics. This file records conventions that are easy to get wrong by pattern-matching against older code that predates them.", "publisher": "smartcontractkit", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Guidance for AI agents working in this repository. Read CONTRIBUTING.md for PR title and merge mechanics. This file records conventions that are easy to get wrong by pattern-matching against older code that predates them." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/smartcontractkit/chainlink-ccv", "path": "AGENTS.md", "ref": "8713af57b8983c9177e77d675a6df5bcdf5368c7", "url": "https://github.com/smartcontractkit/chainlink-ccv/blob/8713af57b8983c9177e77d675a6df5bcdf5368c7/AGENTS.md", "key": "smartcontractkit/chainlink-ccv/AGENTS.md" } }, "instructions": "# AGENTS.md\n\nGuidance for AI agents working in this repository. Read CONTRIBUTING.md for PR title and merge\nmechanics. This file records conventions that are easy to get wrong by pattern-matching against\nolder code that predates them.\n\n## Credentials: secrets file, not environment variables\n\nNew credentials are read from the service's secrets file only. Do not add an environment variable\nfor one.\n\nThe `VERIFIER_AGGREGATOR_*` env vars and `CL_DATABASE_URL` exist only for backwards compatibility\nwith deployments that predate the secrets file. A credential introduced after the file has no such\nhi", "cost": { "context_tokens": 300 } }

chainlink-ccv

About

AGENTS.md

Credentials: secrets file, not environment variables

Use it

Manifest

Reviews