Skip to content

Conversation

@davidfirst
Copy link
Member

Adds a distributable skill that provides Claude Code with accurate Bit CLI command reference, eliminating trial-and-error when running bit commands.

The Problem: When users work with Claude Code on Bit projects, Claude often uses wrong flags for bit commands and has to retry with --help. This wastes tokens and time.

The Solution: A skill that users install globally (~/.claude/skills/bit-cli/) that provides a lookup script. Instead of loading the full 5600-line CLI reference, Claude runs the lookup script which returns only the relevant command info (~20-50 lines).

Files:

  • SKILL.md - Skill definition Claude auto-discovers
  • bit-cli-lookup - Bash script that queries CLI reference via jq
  • README.md - Installation instructions

Installation (one-liner):

mkdir -p ~/.claude/skills/bit-cli && cd ~/.claude/skills/bit-cli && curl -sLO https://raw.githubusercontent.com/teambit/bit/master/contrib/claude-skill-bit-cli/{SKILL.md,bit-cli-lookup} && chmod +x bit-cli-lookup

Add a distributable skill that provides Claude Code with accurate Bit CLI
command reference, eliminating trial-and-error when running bit commands.

- SKILL.md: Skill definition for auto-discovery
- bit-cli-lookup: Bash script to query CLI reference efficiently
- README.md: Installation instructions for users
Copilot AI review requested due to automatic review settings December 26, 2025 21:42
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR adds a distributable Claude Code skill that provides accurate Bit CLI command reference, helping users avoid trial-and-error when running bit commands. The skill includes a lookup script that queries the CLI reference on-demand, returning only relevant command information instead of loading the full reference.

Key Changes:

  • Introduces a bash script (bit-cli-lookup) that queries Bit CLI commands using jq
  • Adds skill definition (SKILL.md) for Claude Code auto-discovery
  • Provides comprehensive installation instructions in README.md

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 7 comments.

File Description
contrib/claude-skill-bit-cli/bit-cli-lookup Bash script with jq-based CLI reference lookup, command formatting, and auto-update functionality
contrib/claude-skill-bit-cli/SKILL.md Skill definition file documenting usage patterns and common commands for Claude Code
contrib/claude-skill-bit-cli/README.md Installation instructions including one-liner setup and troubleshooting guide

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

- Add JSON validation after downloading CLI reference
- Add -f flag to curl commands to fail on HTTP errors
- Split one-liner curl to separate commands for better error handling
- Use generic package manager language in error messages
- Fix grammar: '5000+ line' -> '5000+-line'
@davidfirst
Copy link
Member Author

All Copilot feedback addressed in the latest commit:

  • Added JSON validation after downloading CLI reference (validates with jq empty before replacing)
  • Added -f flag to curl commands to fail on HTTP errors
  • Split one-liner curl to separate commands for better error handling
  • Use generic package manager language in error messages
  • Fixed grammar: '5000+ line' -> '5000+-line'

@davidfirst davidfirst merged commit 0f22da5 into master Dec 29, 2025
12 checks passed
@davidfirst davidfirst deleted the feat/claude-skill-bit-cli branch December 29, 2025 14:06
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