qhelp

name: Qhelp description: Shows QE Framework usage overview. With no arg, prints the full catalog. With a skill name arg (e.g., /Qhelp Qcommit), reads that skill's SKILL.md and summarizes it in the user's language. invocation_trigger: User asks for help, uses /Qhelp, or invokes any QE skill with --help / -h flag. recommendedModel: haiku

Qhelp — QE Framework Reference & Per-Skill Help

Role

Two modes:

No argument: print the full QE Framework reference card (all skills).
With skill argument: read that skill's SKILL.md and generate a per-skill usage summary in the user's language.

Workflow

Mode A: No argument

Print the full reference card below directly to the user.

Mode B: Skill argument (`/Qhelp {skillName}`)

Read .qe/profile/language.md to detect user language. Parse Primary language: <code>. Default to en.
Resolve target: skills/{skillName}/SKILL.md.
If not found: glob skills/*/SKILL.md, compute 3 closest matches by name similarity, output not-found message + suggestions in user's language. Stop.
Read the target SKILL.md. Extract:
- frontmatter description → Section 1
- frontmatter invocation_trigger (or fall back to description) → Section 2
- ## Role section + first workflow/behavior block → Section 3 (3–5 bullets)
- code blocks containing /{skillName} → Section 4 (or default /{skillName} if none)
Output 4 sections with headings in the user's language:
- ko: "한 줄 요약" / "언제 쓰나" / "주요 동작" / "사용 예시"
- en: "Summary" / "When to use" / "What it does" / "Usage"
- ja: "概要" / "使用タイミング" / "主な動作" / "使用例"
- other: English
Keep total output ≤400 words.

Reference Card (Mode A output)

QE Framework (Query Executor) — Quick Reference
================================================

WORKFLOW
  /Qgenerate-spec          Create task spec documents
  /Qrun-task [UUID]        Execute tasks with verification
  /Qcommit                 Commit & push (human-style, no AI traces)
  /Qupdate                 Update QE for Claude or Codex
  /Qutopia [on|off]        Toggle fully autonomous mode

DEVELOPMENT
  /Qsystematic-debugging   Root cause analysis before fixing
  /Qtest-driven-development TDD: red-green-refactor cycle
  /Qcode-run-task          Quality loop: test → review → fix
  /Qfrontend-design        Production-grade UI components
  /Qspringboot-security    Spring Security best practices
  /Qdatabase-schema-designer Database schema design
  /Qdoc-comment            Add doc comments (JSDoc, PyDoc, etc.)
  /Qmcp-setup              MCP server setup + building guide
  /Qagent-browser          Browser automation

TASK MANAGEMENT
  /Qinit                   Initialize QE in a project
  /Qrefresh                Refresh project analysis
  /Qresume                 Restore previous session context
  /Qcompact                Save context / session handoff
  /Qarchive                Archive completed tasks
  /Mmigrate-tasks          Migrate task files to .qe/

DOCUMENTATION
  /Qdocx                   Word documents
  /Qpdf                    PDF operations
  /Qpptx                   Presentations
  /Qxlsx                   Spreadsheets
  /Qwriting-clearly        Clear writing + AI pattern removal
  /Qprofessional-communication  Professional emails & messages
  /Qmermaid-diagrams       Mermaid diagrams
  /Qc4-architecture        C4 architecture diagrams
  /Qimage-analyzer         Image & screenshot analysis

ACADEMIC
  /Qgrad-paper-write       Draft academic papers
  /Qgrad-paper-review      Respond to reviewer comments
  /Qgrad-research-plan     Literature review & experiment design
  /Qgrad-seminar-prep      Prepare presentations
  /Qgrad-thesis-manage     Thesis progress management

PLANNING
  /Qpm-prd                 Write PRDs
  /Qpm-user-story          User stories with Gherkin criteria
  /Qpm-roadmap             Strategic roadmaps
  /Qrequirements-clarity   Clarify ambiguous requirements
  /Qqa-test-planner        QA test plans & bug reports

MEDIA
  /Qaudio-transcriber      Audio → text (meeting notes)
  /Qyoutube-transcript-api YouTube subtitles & transcription
META
  /Qversion                Show current version
  /Mcreate-skill          Create or modify skills
  /Qcommand-creator        Create slash commands
  /Qfind-skills            Search skills.sh marketplace
  /Qalias                  Path & command aliases
  /Qprofile                Analyze usage patterns
  /Mrefactor-agent-md      Refactor instruction files
  /Qweb-design-guidelines  UI/UX review
  /Qlesson-learned         Extract engineering lessons
  /Qhelp                   This help screen

AGENTS (auto-selected by complexity)
  HIGH   Edeep-researcher, Eqa-orchestrator
  MEDIUM Etask-executor, Ecode-debugger, Ecode-reviewer,
         Ecode-test-engineer, Ecode-doc-writer, Edoc-generator,
         Egrad-writer, Epm-planner, Erefresh-executor,
         Ecompact-executor, Ehandoff-executor
  LOW    Earchive-executor, Ecommit-executor, Eprofile-collector

Will

Display the quick reference card (Mode A)
Read a specific skill's SKILL.md and generate a 4-section summary in the user's language (Mode B)
Provide skill-name suggestions when a requested skill is not found

Will Not

Execute any commands from the target skill
Modify any files
Translate the reference card itself (Mode A stays in its native mixed form)

Skill Budget Status

When displaying help, include a budget summary line at the top:

Skills: {count} loaded | Budget: ~{tokens} tokens ({pct}% of 1M context)

This information is calculated by hooks/scripts/lib/skill-budget.mjs:

calculateSkillBudget(skillsDir) — counts SKILL.md files and estimates token usage
checkBudgetOverflow(totalTokens) — checks if budget exceeds 1% of context window
getCompressibleSkills(skillsDir) — lists skills with longest descriptions for compression

If budget overflows (>1% of context), display a warning:

⚠ Budget overflow — consider running skill deduplication audit