Ask Expert Skill

Creates expert consultation documents with automated code extraction, git diffs, and size tracking

Overview

This skill helps Claude create comprehensive technical consultation documents for external expert review. It automatically activates when you ask Claude to prepare code for expert analysis.

For complete plugin documentation, see the main README.

Quick Reference

Example prompts:

"Create an expert consultation document for our authentication refactor"
"Prepare code for expert review about our API design"
"I need to ask an expert about our database schema"

What it does:

Guides you through structuring consultation documents
Extracts code with size tracking (125KB limit)
Organizes content with markdown sections
Supports full files, line ranges, and git diffs

Allowed tools: Bash, Read, Write, Edit

Script Usage

The skill uses a bundled extraction script. For manual usage:

Basic extraction:

node scripts/extract-code.js \
  --track-size --output=doc.md \
  src/file1.ts src/file2.ts

With sections:

node scripts/extract-code.js \
  --track-size --output=doc.md \
  --section="What Changed" src/Service.cs:diff \
  --section="Implementation" src/Service.cs

Git diffs:

node scripts/extract-code.js \
  src/Service.cs:diff=master..feature-branch

Documentation

SKILL.md - Skill definition for Claude
EXAMPLES.md - Detailed usage examples with complete workflows
Script Reference - Run with --help for all options

Requirements

Node.js 18+
Git (for diff functionality)

License

MIT - See LICENSE

1.7 KiB Raw Permalink Blame History