Skip to content

feat: add Gram agent skills for Claude Code#1664

Draft
simplesagar wants to merge 1 commit intomainfrom
feat/agent-skills
Draft

feat: add Gram agent skills for Claude Code#1664
simplesagar wants to merge 1 commit intomainfrom
feat/agent-skills

Conversation

@simplesagar
Copy link
Member

Summary

  • Adds a distributable Claude Code plugin (skills/) with 6 user-facing skills that guide Gram end-users through CLI workflows: deploying OpenAPI specs, deploying functions, installing MCP servers, checking deployment status, and authoring functions with the SDK
  • Adds mise run skills:update task that syncs skills against current CLI help output, validates structure (frontmatter, cross-refs, line counts), and supports version bumping
  • Updates CLAUDE.md with a pointer to the new user-facing skills directory

Skills included

Skill Purpose
gram-context Foundation — CLI reference, auth, config file format
deploy-openapi Deploy OpenAPI v3 specs (stage+push and upload flows)
deploy-functions Deploy Gram Functions zip files
install-mcp-server Install MCP servers in Claude Code, Claude Desktop, Cursor, Gemini CLI
check-deployment-status Monitor and debug deployments
write-gram-function Author functions with @gram-ai/functions SDK

Update task

mise run skills:update                  # validate skills against CLI
mise run skills:update --bump patch     # validate + bump plugin version

Test plan

  • mise run skills:update passes with only 2 acceptable warnings
  • All 6 SKILL.md files have valid YAML frontmatter with trigger phrases
  • Cross-references between skills are consistent
  • plugin.json skills path resolves correctly
  • All skills under 500 lines
  • Install plugin in Claude Code and verify skill activation on trigger phrases

🤖 Generated with Claude Code

Adds a distributable Claude Code plugin with 6 skills that guide Gram
end-users through deploying APIs, functions, and installing MCP servers.
Includes a mise task for keeping skills in sync with CLI changes.

Co-Authored-By: Claude Opus 4.6 <[email protected]>
@vercel
Copy link

vercel bot commented Feb 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
gram-docs-redirect Ready Ready Preview, Comment Feb 23, 2026 4:17am

Request Review

@changeset-bot
Copy link

changeset-bot bot commented Feb 23, 2026

⚠️ No Changeset found

Latest commit: e5ea1d3

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@qstearns qstearns added the preview Spawn a preview environment label Feb 25, 2026
@speakeasybot
Copy link
Collaborator

speakeasybot commented Feb 25, 2026

🚀 Preview Environment (PR #1664)

Preview URL: https://pr-1664.dev.getgram.ai

Component Status Details Updated (UTC)
✅ Database Ready Existing database reused 2026-03-03 17:17:12.
✅ Images Available Container images ready 2026-03-03 17:16:54.

Gram Preview Bot

@@ -0,0 +1,228 @@
---
name: gram-context
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might I suggest you add a section here that explains what gram is?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Idk how you're installing this but I think this has to be at the repo root as a second a second plugin (living along side Chase's hooks plugin)

Luckily you can pattern match off that skill.

Might want to change the top-level directory to "gram-claude-plugin" and then reference it from the skills file

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

preview Spawn a preview environment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants