Getting Started
Install the GitHub Tools agent skill from github-tools.com for Cursor, Claude Code, and other assistants.

This documentation site ships an Agent Skill so assistants integrate @github-tools/sdk consistently — tools, presets, createGithubAgent, durable createDurableGithubAgent, tokens, and approvals.

Docus publishes it under /.well-known/skills/ (Docus: Agent Skills). The skills CLI installs from the site origin below.

Copy-paste prompts for common tasks are embedded on the relevant doc pages (Installation, Quick Start, Presets, Approval control, Durable workflows, Tools catalog, API Reference, Examples) so they sit next to the code they help you write.

Install the skill

Compatible clients discover skills automatically. To install manually:

Terminal
npx skills add https://github-tools.com

For a Vercel preview deployment, use that preview’s https://… origin instead so the CLI picks up the matching catalog. Production always resolves the canonical docs URL above.

The catalog is at https://github-tools.com/.well-known/skills/index.json (and /.well-known/skills/index.json on this site).

Bundled skill

SkillDescription
github-tools-agentsAdd GitHub tools, presets, createGithubAgent, durable createDurableGithubAgent, env tokens, approvals

Sources in the repo: apps/docs/skills/github-tools-agents/ (SKILL.md and references/).

Where to find copy-prompts

TopicPage
Add packages & env · integrate into an existing repoInstallation
First generateText / streamText · new API routeQuick Start
Presets & combining scopesScope with Presets
requireApproval & token safetyControl Write Safety
createDurableGithubAgent & WorkflowDurable workflows
Cherry-pick tool factoriesTools Catalog
Octokit vs tools · createOctokitAPI Reference
Agent patterns & toolpickExamples
Copyright © 2026