Skip to content

feat: add Gram agent skills for Claude Code#1664

Draft
simplesagar wants to merge 8 commits intomainfrom
feat/agent-skills
Draft

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

Conversation

@simplesagar
Copy link
Copy Markdown
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

@vercel
Copy link
Copy Markdown

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 Mar 29, 2026 9:26pm

Request Review

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Feb 23, 2026

⚠️ No Changeset found

Latest commit: cf0fb17

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
Copy Markdown
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-04-20 15:21:49.
✅ Images Available Container images ready 2026-04-20 15:21:22.

Gram Preview Bot

Comment thread skills/skills/gram-context/SKILL.md
Comment thread skills/.claude-plugin/marketplace.json Outdated
simplesagar and others added 2 commits March 28, 2026 18:01
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 <noreply@anthropic.com>
Move skills plugin registration to root marketplace.json (alongside
hooks plugin) instead of a standalone marketplace.json. Add "What is
Gram?" section to gram-context skill per reviewer request.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
… install

Show a one-time modal after onboarding completes with pre-filled
commands to install the Gram marketplace, plugins (hooks + skills),
and connect the user's newly created MCP server to Claude Code.

Also updates the hooks empty state install modal to mention both
gram-hooks and gram-skills plugins.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Move ConnectAgentModal from Home page to AppLayout so it works
globally. Trigger it from three places:
- After login (generic version without toolset slug)
- After onboarding MCP step completes (with toolset slug)
- After any source deploy auto-creates a toolset (with slug)

Modal tracks dismissed slugs so it re-appears for new toolsets
but not for ones the user already saw.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Use useEffect to react to shouldShow changes so the modal opens
when triggers fire after mount. Also prevent login modal from
showing on every login — only show once, then remember dismissal.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add a ConnectAgentButton component that opens the connect agent
modal inline. Place it in the CTA area of both the Sources and
MCP overview pages so users can manually trigger the plugin
install flow at any time.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The local ui/button doesn't have LeftIcon/Text sub-components.
Use Moonshine Button for the ConnectAgentButton which needs them.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Hooks has its own install flow on the Hooks page. This modal
focuses on the skills plugin for deployment workflows.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@qstearns qstearns removed the preview Spawn a preview environment label Apr 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants