quantumbitcz/forge-compression-help
skills/forge-compression-help/SKILL.md
Quick reference card for all Forge compression features -- output modes, inter-agent compression, input compression, and configuration. Use when you need a reminder of compression options or want to understand how compression works.
data-ai
Updated Apr 17, 2026
$ install --global
skillsauthnpx skillsauth add quantumbitcz/dev-pipeline forge-compression-helpInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 7:51 AM5.7s1 file scanned
SKILL.md
- name:
- forge-compression-help
- description:
- Quick reference card for all Forge compression features -- output modes, inter-agent compression, input compression, and configuration. Use when you need a reminder of compression options or want to understand how compression works.
- allowed-tools:
- ['Read', 'Bash', 'Glob', 'Grep']
- disable-model-invocation:
- true
Forge Compression -- Quick Reference Card
Prerequisites
None. This skill is a reference guide.
Instructions
Display the reference card below. If the user asks about a specific section, navigate directly to it.
Error Handling
None. This skill displays static content.
1. User-Facing Output Compression (Caveman Mode)
Controls how Forge talks to YOU. Does not affect inter-agent communication.
| Mode | Command | Effect | Estimated Savings |
|------|---------|--------|-------------------|
| Off | /forge-caveman off | Standard verbose output | 0% |
| Lite | /forge-caveman lite | Drop filler/hedging, keep grammar | ~20% |
| Full | /forge-caveman | Fragments OK, short synonyms, drop articles | ~45% |
| Ultra | /forge-caveman ultra | Max abbreviation, arrows, no conjunctions | ~65% |
Auto-clarity exceptions: Security warnings, irreversible confirmations, AskUserQuestion, escalations, and PR descriptions always use full verbosity regardless of mode.
Persistence: Stored in .forge/caveman-mode. Survives /forge-reset.
2. Inter-Agent Output Compression
Controls how agents talk to EACH OTHER inside the pipeline. Configured in forge-config.md.
| Level | Name | Token Range | Savings | Default Stages |
|-------|------|-------------|---------|----------------|
| 0 | verbose | 800-2000 | 0% | User reports, escalations |
| 1 | standard | 800-2000 | ~20% | Planning, docs, retrospective |
| 2 | terse | 400-1200 | ~45% | Implementation, verification, review |
| 3 | minimal | 100-600 | ~65% | Inner-loop lint/test, mutation, scaffolding |
Configuration:
output_compression:
enabled: true
default_level: terse
auto_clarity: true
per_stage:
PREFLIGHT: standard
EXPLORING: standard
PLANNING: standard
VALIDATING: terse
IMPLEMENTING: terse
VERIFYING: terse
REVIEWING: terse
DOCUMENTING: standard
SHIPPING: verbose
LEARNING: standard
3. Input Compression (Agent Prompt Reduction)
Reduces token cost of agent .md system prompts. Applied offline, not at runtime.
| Command | What It Does |
|---------|-------------|
| /forge-compress | Compress agent prompts (default: agents/ scope) |
| /forge-compress --dry-run | Estimate savings without modifying files |
| /forge-compress --restore | Restore original files from .original.md backups |
| /forge-compress --scope all | Compress agents + modules + shared + config |
| /forge-compress --level 1 | Conservative (~20% reduction) |
| /forge-compress --level 2 | Aggressive (~45% reduction) |
| /forge-compress --level 3 | Ultra (~65% reduction) |
Rules: Preserves frontmatter, code blocks, tables, technical terms, category codes, severity levels, and all numeric thresholds. Compresses prose only.
4. Related Skills
| Skill | Purpose |
|-------|---------|
| /forge-caveman | Toggle user-facing output compression |
| /forge-compress | Compress input files (agent prompts) |
| /forge-commit | Terse conventional commit messages |
| /forge-review | Review with optional terse output format |
| /forge-help | Find the right skill |
5. Configuration Summary
All compression settings in forge-config.md:
# User-facing output (caveman mode)
caveman:
enabled: true # Auto-activate via SessionStart hook
default_mode: ultra # lite | full | ultra
# Inter-agent output compression
output_compression:
enabled: true
default_level: terse # verbose | standard | terse | minimal
auto_clarity: true # Suspend compression for security/escalation
per_stage: { ... } # Per-stage overrides (see section 2)
# Input compression (agent prompts)
# No config -- controlled via /forge-compress flags
See Also
- Output compression spec — see
output-compression.mdinshared - Input compression rules — see
input-compression.mdinshared benchmarks/-- compression measurements (if available)
Related Skills
quantumbitcz/forge
development
VerifiedTrustedCommunity
[writes] Build, fix, deploy, review, or modify code in this project. Universal entry for the forge pipeline. Auto-bootstraps on first run; brainstorms before planning when given a feature description. Use when you want to take any productive action: implementing features, fixing bugs, reviewing branches, deploying, committing, running migrations.
SKILL.mdUpdated Apr 30, 2026
quantumbitcz/forge-admin
tools
VerifiedTrustedCommunity
[writes] Manage forge state and configuration: recovery, abort, config edits, session handoff, automations, playbooks, output compression, knowledge graph maintenance. Use when you need to recover from broken pipeline state, edit settings, or manage long-lived state.
SKILL.mdUpdated Apr 30, 2026
quantumbitcz/forge-handoff
development
VerifiedTrustedCommunity
[writes] Create, list, show, resume, or search forge session handoffs. Use when context is getting heavy and you want to transfer a forge run or conversation into a fresh Claude Code session, or to resume from a prior handoff artefact. Subcommands - no args (write), list, show, resume, search.
SKILL.mdUpdated Apr 23, 2026
quantumbitcz/forge-graph
development
VerifiedTrustedCommunity
[writes] Manage the Neo4j knowledge graph. Subcommands: init, rebuild (writes); status, query <cypher>, debug (read-only). Requires Docker. No default — an explicit subcommand is required. Use when setting up the graph for the first time, rebuilding after major refactors, checking graph health, or running ad-hoc Cypher diagnostics.
SKILL.mdUpdated Apr 21, 2026