Github

github

Generated by Gutenberg. Use this skill to call the github API through the local github CLI.

When to use

• The user asks for data exposed by github (actions, activity, agent-tasks, agents, apps, billing).
• An agent task needs structured JSON from https://api.github.com.
• You need to perform a write/destructive operation on github — always preview first, run with --yes only on explicit user confirmation.

How to invoke

The skill assumes the generated CLI is on PATH (or invoke via scripts/use-go.sh run ./cmd/github from the project directory).

bashCopy code
github operations
github call meta/root --json
github sync --json
github search "<keyword>" --json

Preview a write operation (default behavior, no side effects):

bashCopy code
github call agent-tasks/create-task-in-repo --data '{"example":true}' --json

Execute it (only after explicit user confirmation):

bashCopy code
github call agent-tasks/create-task-in-repo --data '{"example":true}' --yes --json

Authentication

No authentication required.

Operations index

• meta/root (GET /) — read — GitHub API Root
• security-advisories/list-global-advisories (GET /advisories) — read — List global security advisories
• security-advisories/get-global-advisory (GET /advisories/{ghsa_id}) — read — Get a global security advisory
• agent-tasks/list-tasks-for-repo (GET /agents/repos/{owner}/{repo}/tasks) — read — List tasks for repository
• agent-tasks/create-task-in-repo (POST /agents/repos/{owner}/{repo}/tasks) — write — Start a task
• agent-tasks/get-task-by-repo-and-id (GET /agents/repos/{owner}/{repo}/tasks/{task_id}) — read — Get a task by repo
• agent-tasks/list-tasks (GET /agents/tasks) — read — List tasks
• agent-tasks/get-task-by-id (GET /agents/tasks/{task_id}) — read — Get a task by ID
• apps/get-authenticated (GET /app) — read — Get the authenticated app
• apps/create-from-manifest (POST /app-manifests/{code}/conversions) — write — Create a GitHub App from a manifest
• apps/get-webhook-config-for-app (GET /app/hook/config) — read — Get a webhook configuration for an app
• apps/update-webhook-config-for-app (PATCH /app/hook/config) — write — Update a webhook configuration for an app
• apps/list-webhook-deliveries (GET /app/hook/deliveries) — read — List deliveries for an app webhook
• apps/get-webhook-delivery (GET /app/hook/deliveries/{delivery_id}) — read — Get a delivery for an app webhook
• apps/redeliver-webhook-delivery (POST /app/hook/deliveries/{delivery_id}/attempts) — write — Redeliver a delivery for an app webhook
• apps/list-installation-requests-for-authenticated-app (GET /app/installation-requests) — read — List installation requests for the authenticated app
• apps/list-installations (GET /app/installations) — read — List installations for the authenticated app
• apps/get-installation (GET /app/installations/{installation_id}) — read — Get an installation for the authenticated app
• apps/delete-installation (DELETE /app/installations/{installation_id}) — destructive — Delete an installation for the authenticated app
• apps/create-installation-access-token (POST /app/installations/{installation_id}/access_tokens) — write — Create an installation access token for an app
• apps/suspend-installation (PUT /app/installations/{installation_id}/suspended) — write — Suspend an app installation
• apps/unsuspend-installation (DELETE /app/installations/{installation_id}/suspended) — destructive — Unsuspend an app installation
• apps/delete-authorization (DELETE /applications/{client_id}/grant) — destructive — Delete an app authorization
• apps/check-token (POST /applications/{client_id}/token) — write — Check a token
• apps/reset-token (PATCH /applications/{client_id}/token) — write — Reset a token
• apps/delete-token (DELETE /applications/{client_id}/token) — destructive — Delete an app token
• apps/scope-token (POST /applications/{client_id}/token/scoped) — write — Create a scoped access token
• apps/get-by-slug (GET /apps/{app_slug}) — read — Get an app
• classroom/get-an-assignment (GET /assignments/{assignment_id}) — read — Get an assignment
• classroom/list-accepted-assignments-for-an-assignment (GET /assignments/{assignment_id}/accepted_assignments) — read — List accepted assignments for an assignment
• classroom/get-assignment-grades (GET /assignments/{assignment_id}/grades) — read — Get assignment grades
• classroom/list-classrooms (GET /classrooms) — read — List classrooms
• classroom/get-a-classroom (GET /classrooms/{classroom_id}) — read — Get a classroom
• classroom/list-assignments-for-a-classroom (GET /classrooms/{classroom_id}/assignments) — read — List assignments for a classroom
• codes-of-conduct/get-all-codes-of-conduct (GET /codes_of_conduct) — read — Get all codes of conduct
• codes-of-conduct/get-conduct-code (GET /codes_of_conduct/{key}) — read — Get a code of conduct
• credentials/revoke (POST /credentials/revoke) — write — Revoke a list of credentials
• emojis/get (GET /emojis) — read — Get emojis
• actions/get-actions-cache-retention-limit-for-enterprise (GET /enterprises/{enterprise}/actions/cache/retention-limit) — read — Get GitHub Actions cache retention limit for an enterprise
• actions/set-actions-cache-retention-limit-for-enterprise (PUT /enterprises/{enterprise}/actions/cache/retention-limit) — write — Set GitHub Actions cache retention limit for an enterprise
• actions/get-actions-cache-storage-limit-for-enterprise (GET /enterprises/{enterprise}/actions/cache/storage-limit) — read — Get GitHub Actions cache storage limit for an enterprise
• actions/set-actions-cache-storage-limit-for-enterprise (PUT /enterprises/{enterprise}/actions/cache/storage-limit) — write — Set GitHub Actions cache storage limit for an enterprise
• oidc/list-oidc-custom-property-inclusions-for-enterprise (GET /enterprises/{enterprise}/actions/oidc/customization/properties/repo) — read — List OIDC custom property inclusions for an enterprise
• oidc/create-oidc-custom-property-inclusion-for-enterprise (POST /enterprises/{enterprise}/actions/oidc/customization/properties/repo) — write — Create an OIDC custom property inclusion for an enterprise
• oidc/delete-oidc-custom-property-inclusion-for-enterprise (DELETE /enterprises/{enterprise}/actions/oidc/customization/properties/repo/{custom_property_name}) — destructive — Delete an OIDC custom property inclusion for an enterprise
• code-security/get-configurations-for-enterprise (GET /enterprises/{enterprise}/code-security/configurations) — read — Get code security configurations for an enterprise
• code-security/create-configuration-for-enterprise (POST /enterprises/{enterprise}/code-security/configurations) — write — Create a code security configuration for an enterprise
• code-security/get-default-configurations-for-enterprise (GET /enterprises/{enterprise}/code-security/configurations/defaults) — read — Get default code security configurations for an enterprise
• code-security/get-single-configuration-for-enterprise (GET /enterprises/{enterprise}/code-security/configurations/{configuration_id}) — read — Retrieve a code security configuration of an enterprise
• code-security/update-enterprise-configuration (PATCH /enterprises/{enterprise}/code-security/configurations/{configuration_id}) — write — Update a custom code security configuration for an enterprise

…and 1133 more. Run github operations --json for the full list.

Output contract

• All commands accept --json and emit machine-readable output.
• call returns { dryRun, operation, request, response }. dryRun: true means the call was not executed (write op without --yes).
• search returns cached records. sync populates the local SQLite cache.

Provenance

• Schema: gutenberg.blueprint.v1
• Generated by: gutenberg 0.3.0
• Source spec: /tmp/github-api.json