Repository navigation
chore: add agent skill for adding CLI commands - #730
Merged
Merged
Conversation
Add the add-box-cli-command skill under .claude/skills, read by Claude Code and Cursor. It guides agents through wrapping a box-node-sdk method as a CLI command: resolving the SDK method, agreeing the command interface with the user, writing tests first, and regenerating docs.
Coverage Report for CI Build 39947517199Coverage increased (+0.04%) to 84.953%Details
Uncovered ChangesNo uncovered changes found. Coverage RegressionsNo coverage regressions found. Coverage Stats
💛 - Coveralls |
mwwoda
reviewed
Oct 23, 2026
|
|
||
| ## Inputs | ||
|
|
||
| - **SDK method** as `<manager>.<method>`, e.g. `hubCollaborations.createHubCollaborationV2025R0`. If the user describes the operation instead, find the method by its API path (step 1). |
Contributor
There was a problem hiding this comment.
maybe we can mention to always use sdk-gen package for the new comands
|
|
||
| The SDK types many constrained fields as plain `string`. Hub collaboration `role` is `string` in the SDK, while the API accepts only `editor`, `viewer`, and `co-owner`. The SDK also omits required permissions and scopes, and which errors deserve an explanation in help text. | ||
|
|
||
| Check the [Box API reference](https://developer.box.com/reference/) for the endpoint. Every gap left after that becomes a question for step 4. |
Contributor
There was a problem hiding this comment.
maybe we should Box open api schema instead
- use plain `grep` instead of `rg`, which macOS does not ship - take test structure from references/testing.md rather than sibling tests, document the two `test` chain shapes that never run, and set up per-case stubs with `.do()` - require the generated SDK (`sdk-gen`, `this.tsClient`) for new commands - read accepted values, defaults, and required fields from the Box OpenAPI schema, keeping the API reference for scopes and permissions
mwwoda
approved these changes
Oct 23, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add the add-box-cli-command skill under .claude/skills, read by Claude Code and Cursor. It guides agents through wrapping a box-node-sdk method as a CLI command: resolving the SDK method, agreeing the command interface with the user, writing tests first, and regenerating docs.