aiskillstore/marketplace / skills/abdullahmalik17/context7-efficient
context7-efficient
VerifiedToken-efficient library documentation fetcher using Context7 MCP with 86.8% token savings through intelligent shell pipeline filtering. Fetches code examples, API references, and best practices for JavaScript, Python, Go, Rust, and other libraries. Use when users ask about library documentation, need code examples, want API usage patterns, are learning a new framework, need syntax reference, or troubleshooting with library-specific information. Triggers include questions like "Show me React hooks", "How do I use Prisma", "What's the Next.js routing syntax", or any request for library/framework documentation.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.8 KB |
| references/context7-tools.md | markdown | 7.9 KB |
| scripts/extract-code-blocks.sh | script | 1000 B |
| scripts/extract-notes.sh | script | 381 B |
| scripts/extract-signatures.sh | script | 809 B |
| scripts/fetch-docs.sh | script | 5.7 KB |
| scripts/fetch-raw.sh | script | 760 B |
| scripts/mcp-client.py | script | 16.4 KB |
| scripts/start-server.sh | script | 644 B |
| scripts/stop-server.sh | script | 704 B |
| skill-report.json | config | 139.9 KB |
scripts/fetch-docs.sh
View on GitHub#!/bin/bash
# Main orchestrator: Token-efficient documentation fetcher
#
# This script achieves 94% token savings by:
# 1. Fetching raw docs (5,500 tokens stay in shell)
# 2. Filtering with grep/awk/sed (0 LLM tokens!)
# 3. Returning condensed output (~350 tokens to Claude)
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# Parse arguments
LIBRARY_ID=""
TOPIC=""
MODE="code"
PAGE=1
VERBOSE=0
usage() {
cat << USAGE
Usage: $0 [OPTIONS]
Token-efficient documentation fetcher using Context7 MCP
OPTIONS:
--library-id ID Context7 library ID (e.g., /reactjs/react.dev)
--library NAME Library name (will resolve to ID)
--topic TOPIC Topic to focus on (e.g., hooks, routing)
--mode MODE Mode: code (default) or info
--page NUM Page number (1-10, default: 1)
--verbose, -v Show token statistics
--help, -h Show this help
EXAMPLES:
# Quick lookup with known library ID
$0 --library-id /reactjs/react.dev --topic useState
# Resolve library name first
$0 --library react --topic hooks --mode code
# Get conceptual info
$0 --library-id /prisma/docs --topic "getting started" --mode info
# Pagination
$0 --library react --topic hooks --page 2 --verbose
USAGE
exit 1
}
# Parse arguments
while [[ $# -gt 0 ]]; do
case $1 in
--library-id)
LIBRARY_ID="$2"
shift 2
;;
--library)
LIBRARY_NAME="$2"
shift 2
;;
--topic)
TOPIC="$2"
shift 2
;;
--mode)
MODE="$2"
shift 2
;;
--page)
PAGE="$2"
shift 2
;;
-v|--verbose)
VERBOSE=1
shift
;;
-h|--help)
usage
;;
*)
echo "Unknown option: $1" >&2
usage
;;
esac
done
# Resolve library if name provided
if [ -n "${LIBRARY_NAME:-}" ] && [ -z "$LIBRARY_ID" ]; then
[ $VERBOSE -eq 1 ] && echo "π Resolving library: $LIBRARY_NAME..." >&2
# Call resolve-library-id
RESOLVE_JSON=$(python3 "$SCRIPT_DIR/mcp-client.py" call \
-s "npx -y @upstash/context7-mcp" \
-t resolve-library-id \
-p "{\"libraryName\": \"$LIBRARY_NAME\"}" 2>/dev/null)
# Extract text from JSON (fallback to Python if jq not available)
if command -v jq &> /dev/null; then
RESOLVE_TEXT=$(echo "$RESOLVE_JSON" | jq -r '.content[0].text')
else
RESOLVE_TEXT=$(echo "$RESOLVE_JSON" | python3 -c 'import sys, json; data=json.load(sys.stdin); print(data.get("content", [{}])[0].get("text", ""))')
fi
# Extract first library ID using grep
LIBRARY_ID=$(echo "$RESOLVE_TEXT" | grep -oP 'Context7-compatible library ID:\s*\K[/\w.-]+' | head -n 1)
[ $VERBOSE -eq 1 ] && echo "β
Resolved to: $LIBRARY_ID" >&2
fi
# Validate library ID
if [ -z "$LIBRARY_ID" ]; then
echo "Error: Must specify --library-id or --library" >&2
usage
fi
# Step 1: Fetch raw documentation (stays in shell memory!)
[ $VERBOSE -eq 1 ] && echo "π Fetching documentation..." >&2
RAW_JSON=$("$SCRIPT_DIR/fetch-raw.sh" "$LIBRARY_ID" "$TOPIC" "$MODE" "$PAGE")
# Step 2: Extract text from JSON (using Python if jq not available)
if command -v jq &> /dev/null; then
RAW_TEXT=$(echo "$RAW_JSON" | jq -r '.content[0].text // empty')
else
RAW_TEXT=$(echo "$RAW_JSON" | python3 -c 'import sys, json; data=json.load(sys.stdin); print(data.get("content", [{}])[0].get("text", ""))')
fi
if [ -z "$RAW_TEXT" ]; then
echo "Error: No documentation received from Context7" >&2
exit 1
fi
# Calculate raw token count (approximate: words * 1.3)
if [ $VERBOSE -eq 1 ]; then
RAW_WORDS=$(echo "$RAW_TEXT" | wc -w)
RAW_TOKENS=$(echo "$RAW_WORDS * 1.3" | bc | cut -d. -f1)
echo "π Raw response: ~$RAW_WORDS words (~$RAW_TOKENS tokens)" >&2
fi
# Step 3: Filter using shell tools (0 LLM tokens!)
# This is where the magic happens - all processing stays in shell
OUTPUT=""
if [ "$MODE" = "code" ]; then
# Code mode: Extract code examples and API signatures
# Extract code blocks
CODE_BLOCKS=$(echo "$RAW_TEXT" | "$SCRIPT_DIR/extract-code-blocks.sh" 5)
if [ -n "$CODE_BLOCKS" ] && [ "$CODE_BLOCKS" != "# No code blocks found" ]; then
OUTPUT+="## Code Examples\n\n$CODE_BLOCKS\n"
fi
# Extract API signatures
SIGNATURES=$(echo "$RAW_TEXT" | "$SCRIPT_DIR/extract-signatures.sh" 3)
if [ -n "$SIGNATURES" ]; then
OUTPUT+="\n## API Signatures\n\n$SIGNATURES\n"
fi
else
# Info mode: Extract conceptual content
# Get fewer code examples (2 max)
CODE_BLOCKS=$(echo "$RAW_TEXT" | "$SCRIPT_DIR/extract-code-blocks.sh" 2)
if [ -n "$CODE_BLOCKS" ] && [ "$CODE_BLOCKS" != "# No code blocks found" ]; then
OUTPUT+="## Examples\n\n$CODE_BLOCKS\n"
fi
# Extract key paragraphs (first 3 substantial paragraphs)
OVERVIEW=$(echo "$RAW_TEXT" | \
awk 'BEGIN{RS=""; FS="\n"} length($0) > 200 && !/```/{print; if(++count>=3) exit}')
if [ -n "$OVERVIEW" ]; then
OUTPUT+="\n## Overview\n\n$OVERVIEW\n"
fi
fi
# Always add important notes
NOTES=$(echo "$RAW_TEXT" | "$SCRIPT_DIR/extract-notes.sh" 3)
if [ -n "$NOTES" ]; then
OUTPUT+="\n## Important Notes\n\n$NOTES\n"
fi
# Fallback if no content extracted
if [ -z "$OUTPUT" ]; then
OUTPUT=$(echo "$RAW_TEXT" | head -c 500)
OUTPUT+="\n\n[Response truncated for brevity...]"
fi
# Step 4: Output filtered content (this is what enters Claude's context!)
echo -e "$OUTPUT"
# Calculate filtered token count and savings
if [ $VERBOSE -eq 1 ]; then
FILTERED_WORDS=$(echo -e "$OUTPUT" | wc -w)
FILTERED_TOKENS=$(echo "$FILTERED_WORDS * 1.3" | bc | cut -d. -f1)
SAVINGS=$(echo "scale=1; (($RAW_TOKENS - $FILTERED_TOKENS) / $RAW_TOKENS) * 100" | bc)
echo "" >&2
echo "β¨ Filtered output: ~$FILTERED_WORDS words (~$FILTERED_TOKENS tokens)" >&2
echo "π° Token savings: ${SAVINGS}%" >&2
fi
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path β even casually (like "the xlsx in my downloads") β and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |