quantumbitcz/forge-compress
skills/forge-compress/SKILL.md
[writes] Unified compression — `agents` compresses agent .md files for 30-50% system-prompt reduction; `output <mode>` sets runtime output compression (off|lite|full|ultra) writing .forge/caveman-mode; `status` shows current settings (default, read-only); `help` prints reference card. Use when you want to save tokens on prompts or session output. Trigger: /forge-compress, compress agents, compress output, caveman mode, reduce tokens
documentation
Updated Apr 20, 2026
$ install --global
skillsauthnpx skillsauth add quantumbitcz/dev-pipeline forge-compressInstall 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 20, 2026, 5:16 AM5.6s1 file scanned
SKILL.md
- name:
- forge-compress
- description:
- [writes] Unified compression — `agents` compresses agent .md files for 30-50% system-prompt reduction; `output <mode>` sets runtime output compression (off|lite|full|ultra) writing .forge/caveman-mode; `status` shows current settings (default, read-only); `help` prints reference card. Use when you want to save tokens on prompts or session output. Trigger: /forge-compress, compress agents, compress output, caveman mode, reduce tokens
- allowed-tools:
- ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep', 'Agent']
Forge Compress
Single entry point for compression. Replaces /forge-compress (previous agent-only surface), /forge-caveman, and /forge-compression-help (all removed in 3.0.0).
Subcommands
| Subcommand | Read/Write | Purpose |
|---|---|---|
| agents | writes | Compress agent .md files via terse-rewrite (30–50% reduction) |
| output <mode> | writes | Set output compression. mode ∈ {off, lite, full, ultra}. Writes .forge/caveman-mode |
| status (default) | read-only | Show current agent-compression ratio and output-mode |
| help | read-only | Reference card (flags, modes, token savings by mode, tips) |
Flags
- --help: print usage and exit 0
- --dry-run: (agents, output) preview without writing
- --json: (status, help) structured output
Exit codes
See shared/skill-contract.md for the standard exit-code table.
Prerequisites
- Forge plugin installed and
agents/directory present (foragentssubcommand) .forge/directory writable (foroutputsubcommand, which persists.forge/caveman-mode)
Instructions
Dispatch the compression op to the orchestrator or the underlying compression pipeline:
agents: compress allagents/fg-*.mdfiles via terse rewriting; preserves code blocks, YAML frontmatter, and all technical rules. Seeshared/output-compression.mdandshared/agent-ui.md.output <mode>: write the mode string (off|lite|full|ultra) to.forge/caveman-mode. The runtime reads this at agent dispatch time to select the per-stage compression level.status(default): read current agent file sizes and.forge/caveman-mode, report ratios.help: emit the reference card inline.
Error Handling
Exit codes per shared/skill-contract.md:
- 0: success
- 1: bad args (e.g., unknown mode passed to
output) - 2: validation failure
- 4: aborted by user
See Also
/forge-insights-- View compression-effectiveness analytics across runs/forge-config-- Toggle compression defaults in forge-config.md/forge-status-- Check current compression mode at runtime
References
shared/skill-contract.md— standard exit codes and flag conventionsshared/output-compression.md— per-stage output compression level modelshared/input-compression.md— agent prompt compression pipeline
Examples
/forge-compress # default: status
/forge-compress output lite # set lite mode
/forge-compress output ultra --dry-run # preview ultra without writing
/forge-compress agents # compress all agent .md
/forge-compress agents --dry-run # preview compression
/forge-compress help # reference card
/forge-compress status --json # JSON for scripting
Modes (output subcommand)
| Mode | Token savings | Description | |------|---------------|-------------| | off | 0% | Full verbose output (default) | | lite | ~30% | Strip redundant narration; keep code/data intact | | full | ~55% | Aggressive prose compression; ellipsis-heavy | | ultra | ~75% | Caveman grammar; skeletal output only |
Replacements for removed skills:
| Old skill | New invocation | |---|---| | /forge-caveman | /forge-compress output <mode> | | /forge-compression-help | /forge-compress help |
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