Skip to content

Add Grid API Claude skill#136

Merged
jklein24 merged 5 commits intomainfrom
jk/grid-claude-skill
Feb 4, 2026
Merged

Add Grid API Claude skill#136
jklein24 merged 5 commits intomainfrom
jk/grid-claude-skill

Conversation

@jklein24
Copy link
Contributor

Claude skill for Grid API operations and documentation:

  • SKILL.md: Main skill file with triggers and CLI command reference
  • references/endpoints.md: API endpoint reference extracted from OpenAPI
  • references/account-types.md: Country-to-account-type mapping for international payments
  • references/workflows.md: Common payment workflow guides

The skill enables Claude to:

  • Execute API operations using the CLI tool
  • Answer questions about the Grid API by reading docs
  • Guide users through interactive payment workflows

Copy link
Contributor Author

jklein24 commented Jan 27, 2026

This stack of pull requests is managed by Graphite. Learn more about stacking.

@jklein24 jklein24 mentioned this pull request Jan 27, 2026
@jklein24 jklein24 force-pushed the jk/grid-claude-skill branch from c0efaa6 to 54cfae5 Compare January 27, 2026 19:30
@jklein24 jklein24 force-pushed the jk/grid-cli-commands branch from e7f67f3 to 2da2ad3 Compare January 27, 2026 19:30
@jklein24 jklein24 force-pushed the jk/grid-claude-skill branch 2 times, most recently from 2732c01 to 83fe5c4 Compare January 27, 2026 19:55
@jklein24 jklein24 force-pushed the jk/grid-cli-commands branch from f4e9275 to 294da99 Compare January 27, 2026 19:55
@jklein24 jklein24 force-pushed the jk/grid-claude-skill branch from 83fe5c4 to 7be6436 Compare January 31, 2026 05:53
@jklein24 jklein24 marked this pull request as ready for review February 1, 2026 06:31
@greptile-apps
Copy link
Contributor

greptile-apps bot commented Feb 1, 2026

Greptile Overview

Greptile Summary

Added a comprehensive Claude Code skill for Grid API operations. The skill enables Claude to execute API operations via CLI, answer documentation questions, and guide users through payment workflows. The PR includes the main skill file with CLI command reference, endpoint documentation, country-specific account requirements, and workflow guides for common payment scenarios.

Key additions:

  • Main skill file (.claude/skills/grid-api/SKILL.md) with complete CLI reference and configuration instructions
  • API endpoint reference (references/endpoints.md) extracted from OpenAPI specification
  • Country-to-account-type mapping (references/account-types.md) for international payments
  • Payment workflow guides (references/workflows.md) for common scenarios (UMA payments, international transfers, on-ramp, off-ramp)
  • Updated README.md with setup instructions for the Claude skill

Previous feedback addressed:

  • Build prerequisites documented in both SKILL.md (lines 58-61) and README.md (lines 900-903)
  • Clear setup instructions before usage sections

Confidence Score: 5/5

  • Safe to merge - documentation-only changes with comprehensive coverage
  • All files are documentation, no code changes, previous feedback addressed, comprehensive and well-organized content
  • No files require special attention

Important Files Changed

Filename Overview
.claude/skills/grid-api/SKILL.md New Claude skill file with comprehensive CLI documentation, includes build prerequisites as noted in previous thread
README.md Added Claude Code skill section with setup instructions and build step, addresses previous feedback

Sequence Diagram

sequenceDiagram
    participant User
    participant Claude
    participant Skill as Grid API Skill
    participant CLI as CLI Tool
    participant API as Grid API

    User->>Claude: Ask to send payment to Mexico
    Claude->>Skill: Invoke /grid-api skill
    Skill->>Skill: Read references/account-types.md<br/>(check Mexico requirements)
    Skill->>Claude: Show CLABE requirements
    Claude->>User: Ask for CLABE number & beneficiary details
    User->>Claude: Provide account details
    Claude->>CLI: node cli/dist/index.js accounts external create
    CLI->>API: POST /customers/external-accounts
    API-->>CLI: ExternalAccount created
    CLI-->>Claude: Account created response
    Claude->>CLI: node cli/dist/index.js quotes create
    CLI->>API: POST /quotes
    API-->>CLI: Quote with exchange rate
    CLI-->>Claude: Quote details
    Claude->>User: Show exchange rate & confirm
    User->>Claude: Confirm
    Claude->>CLI: node cli/dist/index.js quotes execute
    CLI->>API: POST /quotes/{id}/execute
    API-->>CLI: Transaction initiated
    CLI-->>Claude: Transaction status
    Claude->>User: Payment sent successfully
Loading

Copy link
Contributor

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

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

2 files reviewed, 2 comments

Edit Code Review Agent Settings | Greptile

@jklein24 jklein24 force-pushed the jk/grid-cli-commands branch from 8adaf9e to c534755 Compare February 1, 2026 08:05
@jklein24 jklein24 force-pushed the jk/grid-claude-skill branch from 7be6436 to baf7e1b Compare February 1, 2026 08:05
Copy link
Contributor Author

@jklein24 jklein24 left a comment

Choose a reason for hiding this comment

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

Addressed Greptile review feedback:

SKILL.md:68 - Applied. Added build prerequisites section before the Configuration section.

README.md:909 - Applied. Added Setup section with build instructions before the Usage section.

Review response generated using /pr-review-respond Claude command.

@jklein24 jklein24 requested a review from shreyav February 3, 2026 19:58
@jklein24 jklein24 force-pushed the jk/grid-cli-commands branch from c534755 to 2d4aaa9 Compare February 4, 2026 06:49
@jklein24 jklein24 force-pushed the jk/grid-claude-skill branch from fa858e4 to dbbe9df Compare February 4, 2026 06:49
@jklein24 jklein24 changed the base branch from jk/grid-cli-commands to graphite-base/136 February 4, 2026 06:55
jklein24 and others added 4 commits February 4, 2026 06:55
Claude skill for Grid API operations and documentation:
- SKILL.md: Main skill file with triggers and CLI command reference
- references/endpoints.md: API endpoint reference extracted from OpenAPI
- references/account-types.md: Country-to-account-type mapping for international payments
- references/workflows.md: Common payment workflow guides

The skill enables Claude to:
- Execute API operations using the CLI tool
- Answer questions about the Grid API by reading docs
- Guide users through interactive payment workflows
- Add "Common Mistakes to Avoid" section for external accounts and quotes
- Fix Nigerian account example: use --bank-name (not --bank-code), add --purpose
- Clarify individual beneficiary requirements (birth date, nationality required)
- Add --dest-currency requirement note for quotes to external accounts
- Add separate individual/business examples for CLABE accounts

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add `grid configure` command as primary setup method
- Document command aliases (cust, tx, acct)
- Document output options (--format table, --no-color)
- Document delete confirmation and --yes flag
- Add input validation to best practices
- Update workflow examples to use aliases and table format

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jklein24 jklein24 force-pushed the jk/grid-claude-skill branch from dbbe9df to 54320b8 Compare February 4, 2026 06:55
@graphite-app graphite-app bot changed the base branch from graphite-base/136 to main February 4, 2026 06:56
- Add build step to SKILL.md Configuration section
- Add Setup section with build instructions to README.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@jklein24 jklein24 force-pushed the jk/grid-claude-skill branch from 54320b8 to e014cd2 Compare February 4, 2026 06:56
@jklein24 jklein24 merged commit a8729a8 into main Feb 4, 2026
5 checks passed
Copy link
Contributor Author

jklein24 commented Feb 4, 2026

Merge activity

@jklein24 jklein24 deleted the jk/grid-claude-skill branch February 4, 2026 16:30
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.

2 participants