Mintlify API
macro-inc/macro
Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically.
A walkthrough of the Gram Functions feature in this codebase
$ npx skills add speakeasy-api/gram --skill gram-functions -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install speakeasy-api/gram gram-functions --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/speakeasy-api/gram.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/gram-functions .claude/skills/gram-functions && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "gram-functions" agent skill from https://github.com/speakeasy-api/gram/tree/main/.agents/skills/gram-functions into .claude/skills/gram-functions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gram-functions", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/speakeasy-api/gram/tree/main/.agents/skills/gram-functionsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add speakeasy-api/gram --skill gram-functions -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install speakeasy-api/gram gram-functions --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/speakeasy-api/gram.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/gram-functions .agents/skills/gram-functions && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "gram-functions" agent skill from https://github.com/speakeasy-api/gram/tree/main/.agents/skills/gram-functions into .agents/skills/gram-functions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gram-functions", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add speakeasy-api/gram --skill gram-functions -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install speakeasy-api/gram gram-functions --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/speakeasy-api/gram.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/gram-functions .cursor/skills/gram-functions && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "gram-functions" agent skill from https://github.com/speakeasy-api/gram/tree/main/.agents/skills/gram-functions into .cursor/skills/gram-functions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gram-functions", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/speakeasy-api/gram.git --path .agents/skills/gram-functions--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add speakeasy-api/gram --skill gram-functions -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install speakeasy-api/gram gram-functions --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/speakeasy-api/gram.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/gram-functions .gemini/skills/gram-functions && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "gram-functions" agent skill from https://github.com/speakeasy-api/gram/tree/main/.agents/skills/gram-functions into .gemini/skills/gram-functions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gram-functions", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install speakeasy-api/gram gram-functionsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add speakeasy-api/gram --skill gram-functions -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/speakeasy-api/gram.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/gram-functions .github/skills/gram-functions && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "gram-functions" agent skill from https://github.com/speakeasy-api/gram/tree/main/.agents/skills/gram-functions into .github/skills/gram-functions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gram-functions", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add speakeasy-api/gram --skill gram-functions -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install speakeasy-api/gram gram-functions --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/speakeasy-api/gram.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/gram-functions .opencode/skills/gram-functions && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "gram-functions" agent skill from https://github.com/speakeasy-api/gram/tree/main/.agents/skills/gram-functions into .opencode/skills/gram-functions/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gram-functions", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
gram-functionsA walkthrough of the Gram Functions feature in this codebase
Gram Functions is an agent skill from speakeasy-api/gram. A walkthrough of the Gram Functions feature in this codebase
Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Backend & APIs. The repository describes itself as: Securely scale AI usage across your organization. A single stack to Connect, Secure, Observe and Distribute agents, MCPs, and Skills within your company. The licence is AGPL-3.0.
3 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit ad78247. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
nodepythonFrom the folder's file list and the shell code blocks in SKILL.md.
Links to these hosts (documentation or services it may open):
github.comFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Gram Functions loads about 2k tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 733 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from speakeasy-api/gram at commit ad78247, republished under its AGPL-3.0 licence (© speakeasy-api). 733 words, ~2,039 tokens.
.claude/skills/gram-functions/SKILL.md (or your agent's skills folder).Gram Functions is a serverless code execution feature that allows users to deploy custom JavaScript/TypeScript or Python code as callable tools within Gram deployments. Functions can be invoked by AI agents during conversations.
| Package | Purpose |
|---|---|
server/internal/functions/ | Core functions service - deployment, execution, auth |
server/internal/background/activities/ | Temporal activities for deploying/reaping function runners |
server/design/functions/ | Goa API design for functions endpoints |
server/internal/functions/)impl.go - API service, handles signed asset URL requests from runnersdeploy.go - Core interfaces: Deployer, ToolCaller, Orchestratordeploy_fly.go - Fly.io integration via Machines APImanifest.go - Manifest format (ManifestV0) describing exported tools/resourcesruntimes.go - Supported runtime definitions (JS, TS, Python)auth.go - JWT authentication for function runnersqueries.sql - SQL queries for fly_apps table managementserver/internal/background/)activities/deploy_function_runners.go - Deploys runners during deployment processingactivities/reap_functions.go - Cleans up old Fly.io appsactivities/provision_functions_access.go - Creates access credentials for runnersfunctions_reaper.go - Temporal workflow for cleanup (triggered per-project after deployments)functions/)The functions/ directory contains the source code and build configuration for the OCI images that run user functions on Fly.io. These images are built using melange and apko for reproducible, minimal container images.
| File | Purpose |
|---|---|
melange.yaml | Builds the gram-runner Go binary as an APK package |
images/nodejs22-alpine3.22.yaml | apko config for Node.js 22 runtime image |
images/python3.12-alpine3.22.yaml | apko config for Python 3.12 runtime image |
Each runtime image contains:
ca-certificates-bundle, su-exec)nodejs or python3)gram-runner binary (built from cmd/runner/main.go)Entrypoint behavior:
gram-runner -init -language <lang> - Initializes filesystem, unzips user codesu-exec gram - Drops privileges to non-root gram user (UID 10000)gram-runner -language <lang> - Starts HTTP server on port 8888cmd/runner/main.go)The gram-runner binary is an HTTP server that:
:8888 for tool call and resource requestsfunctions/internal/)| Package | Purpose |
|---|---|
auth/ | JWT authentication and request authorization middleware |
bootstrap/ | Machine initialization: unzip code, prepare entrypoints, lazy asset loading |
encryption/ | AES-GCM encryption for secure communication |
guardian/ | Process execution with resource limits |
ipc/ | Named pipe (FIFO) creation for subprocess communication |
javascript/ | JavaScript/TypeScript entrypoint script (gram-start.js) |
python/ | Python entrypoint script (gram_start.py) |
runner/ | HTTP handlers for /tool-call and /resource-request endpoints |
svc/ | Service utilities (idle tracking, secrets, errors) |
o11y/ | Observability setup (OpenTelemetry, logging) |
middleware/ | HTTP middleware (recovery, version header) |
attr/ | Structured logging attribute helpers |
POST /tool-call with JSON payload:{"name": "tool_name", "input": {...}, "environment": {...}}node --experimental-strip-types gram-start.js or python gram_start.pyFor large function bundles (>700KiB), the code isn't embedded in the Fly machine config. Instead:
.lazy file is written containing the asset IDbootstrap.resolveLazyFile() detects the .lazy file| Table | Purpose |
|---|---|
deployments_functions | Links functions to deployments, stores runtime/slug |
functions_access | Encryption keys and bearer token formats for auth |
fly_apps | Tracks deployed Fly.io apps (status, region, URL, reap state) |
function_tool_definitions | Tool metadata (name, description, input schema, variables) |
function_resource_definitions | Resource metadata (URI, mime type) |
manifest.jsonDeployFunctionRunners activityFlyRunner.ToolCall() sends authenticated HTTP request/tool-call endpointnode/python) with user codeserver/internal/deployments/impl.go)reaped_at in databaseFunctionsReaperScopeGlobal scope exists in the code but is not currently used/scheduled© speakeasy-api, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .agents/skills/gram-functions of speakeasy-api/gram.
Open the folder on GitHubat commit ad78247
Gram Functions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Gram Functions this skillspeakeasy-api/gram | 272 | — | ~2k | Automated safety check: Pass | AGPL-3.0 | |
| Mintlify APImacro-inc/macro | 4.6k | 2 repos | ~333 | Automated safety check: Pass | MIT | |
| Rtvi Vlm Perf TestingNVIDIA-AI-Blueprints/video-search-and-summarization | 1.9k | — | ~8.6k | Automated safety check: Notes | Apache-2.0 | |
| Frappe Ops Website DeployImpertio-Studio/Frappe_Claude_Skill_Package | 187 | — | ~2.5k | Automated safety check: Pass | MIT | |
| Noodle Usewilfredinni/noodle | 363 | — | ~8.5k | Automated safety check: Notes | Apache-2.0 | |
| Supercheck Feature Implementationsupercheck-io/supercheck | 215 | — | ~1.1k | Automated safety check: Pass | AGPL-3.0 |
macro-inc/macro
Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically.
NVIDIA-AI-Blueprints/video-search-and-summarization
Plan, run, and diagnose reproducible RT-VLM GPU performance canaries and benchmarks.
Impertio-Studio/Frappe_Claude_Skill_Package
Deploy HTML/CSS websites to ERPNext/Frappe (v15/v16) as Web Pages via the REST API.
wilfredinni/noodle
Teach agents to create, organize, maintain, evaluate, import, convert, and automate noodle terminal REST client collections using supported CLI commands plus YAML and dotenv files.
supercheck-io/supercheck
Implement a new or changed Supercheck feature end to end across schema, auth/RBAC, services, routes/actions, UI, queues/workers, CLI/recorder, tests, docs, and deployment contracts.
ruvnet/agentic-flow
Comprehensive Flow Nexus platform management - authentication, sandboxes, app deployment, payments, and challenges
speakeasy-api/gram
A skill your agent uses when automating the Gram dashboard in a browser, capturing screenshots, inspecting pages.
speakeasy-api/gram
A skill your agent uses when adding, changing, restyling, reviewing, validating, or previewing a Gram/Speakeasy transactional email, in Go or in LMX/MJML — a template<name.go, a TemplateKey…
speakeasy-api/gram
A skill your agent uses when adding, changing, or styling UI in client/admin (the Gram admin dashboard) that touches shadcn/ui — a button, dialog, table, sidebar, badge, select, tabs, tooltip, card…
speakeasy-api/gram
A skill your agent uses when adding, editing, reviewing, testing, or locating a reviewed skill distributed with the Platform MCP plugin; triggers include "Platform MCP skill", "platformmcpskills"…
speakeasy-api/gram
A skill your agent uses when changing or reviewing Gram ClickHouse schemas, migrations, queries, inserts, access principals, bootstrap SQL, Cloud compatibility, partial migration failures, or…
speakeasy-api/gram
A skill your agent uses when gating a feature behind a flag, dogfooding or gradually rolling out a change, choosing between productfeatures and PostHog feature flags, adding or checking a product…
Categories
A walkthrough of the Gram Functions feature in this codebase. Gram Functions is an agent skill from speakeasy-api/gram.
Gram Functions fits situations like: backend & APIs work in your project.
Run `npx skills add speakeasy-api/gram --skill gram-functions -a claude-code`. Or copy the skill folder (.agents/skills/gram-functions in speakeasy-api/gram) into .claude/skills/gram-functions in your project. Claude Code loads it when a task matches its description.
Run `npx skills add speakeasy-api/gram --skill gram-functions -a codex`. Or copy the skill folder (.agents/skills/gram-functions in speakeasy-api/gram) into .agents/skills/gram-functions in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add speakeasy-api/gram --skill gram-functions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gram-functions, .gemini/skills/gram-functions, .github/skills/gram-functions and .opencode/skills/gram-functions in your project.
Going by SKILL.md and its folder, Gram Functions needs the command-line tools its instructions call (node and python). Our summary lists: Python 3; Node.js.
SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Gram Functions is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2k tokens (SKILL.md is roughly 8.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Gram Functions: Mintlify API (macro-inc/macro, 4.6k stars), Rtvi Vlm Perf Testing (NVIDIA-AI-Blueprints/video-search-and-summarization, 1.9k stars), Frappe Ops Website Deploy (Impertio-Studio/Frappe_Claude_Skill_Package, 187 stars) and Noodle Use (wilfredinni/noodle, 363 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
speakeasy-api (a GitHub organization) maintains it in speakeasy-api/gram, which has 272 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 8, 2026.
Source: speakeasy-api/gram on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.