A skill does not connect to your account or make calls by itself. Use the MCP server for authenticated tools, or provide
CONTEXT_DEV_API_KEY to a trusted local runtime when the agent needs to run code.Install
Install into the current project when teammates and automation should use the same checked-in instructions:--agent codex, for example, to select a specific agent. Use npx skills add --help to inspect the current options.
Use the site URL for the installer, not /skill.md. The file URL is for review or a manual installation.
Review before installing
The hosted source is public:Manual project install
Agents that support the shared.agents/skills convention can read this layout:
Verify the skill
Start a fresh agent session in the project and ask:
Using the Context.dev skill, show the canonical HTTPS request to retrieve a brand from stripe.com. Do not run it.
A loaded skill should use POST /v1/brand/retrieve with this body:
- the installed filename is
SKILL.md; - the skill directory is one your agent reads;
- the session was restarted after installation;
- another Context.dev instruction file is not shadowing it.
Run code with your key
The agent quickstart can provision and save a key through auth.md, after you complete the browser claim. For an existing key, expose it to the process through a secret manager,.envrc, or ignored environment file:
Update the skill
The skill is intentionally concise and routes the agent to the API reference for full schemas. When updating a pinned copy:- Review the diff.
- Confirm canonical Brand, Web, batch, and monitor routes.
- Re-run your integration tests against the updated SDK or HTTPS contract.
- Restart the agent session so it reloads the instructions.
Next steps
Agent quickstart
Turn an integration goal into a scoped task for your agent.
Connect MCP
Let your agent use live Context.dev tools alongside the skill.
Read the skill
Inspect the public instructions before installing or updating them.