Skip to content

feat: add steno-mode skill for shorthand response compression and token saving #2252

Open
AkashAi7 wants to merge 2 commits into
github:mainfrom
AkashAi7:add-steno-skill
Open

feat: add steno-mode skill for shorthand response compression and token saving #2252
AkashAi7 wants to merge 2 commits into
github:mainfrom
AkashAi7:add-steno-skill

Conversation

@AkashAi7

@AkashAi7 AkashAi7 commented Jul 9, 2026

Copy link
Copy Markdown

What

Adds the steno-mode skill — a shorthand-first response compression mode that cuts ~40% of response tokens while keeping every code literal, command, path, and error message exactly intact.

Why

Long agent sessions burn output tokens on prose filler. Steno Mode compresses responses through consistent, readable shorthand rules (stable abbreviations, symbolic chains like \X -> Y -> Z, filler removal) rather than random truncation. Priority order is exactness > readability > compression, so technical precision is never sacrificed.

Details

  • 4 compression levels: \lite, \brief\ (default), \court, \machine\
  • Explicit protect-list: code blocks, commands, paths, identifiers, env vars, error text, versions stay verbatim
  • Honest scope section: works well for code review / debugging / architecture summaries; explicitly defers to prose for tutorials, stakeholder comms, and teaching
  • Benchmarked on 50+ samples across 7 categories with exact token counts (gpt-tokenizer): ~40% avg reduction, 100% literal accuracy — interactive benchmark at https://akashai7.github.io/stenographer-mode/demo/

Checklist


  • pm run skill:validate\ passes (all 371 skills valid)

  • pm start\ run — docs/README.skills.md updated
  • Branch created from \main\
  • No duplicate of existing skills (searched for steno/token/compress/shorthand/concise)

Copilot AI review requested due to automatic review settings July 9, 2026 11:39
@AkashAi7 AkashAi7 requested a review from aaronpowell as a code owner July 9, 2026 11:39
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

🟡 Contributor Reputation Check: MEDIUM risk

Check Risk
Profile MEDIUM
Credential audit NONE

Maintainers: please review this contributor before merging.
See the workflow run for full details.
Automated check powered by AGT.

@github-actions github-actions Bot added the needs-review:MEDIUM Contributor reputation check flagged MEDIUM risk label Jul 9, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new Agent Skill (steno-mode) to the skills/ catalog, plus the generated docs entry, enabling a shorthand-first response compression mode intended to reduce output tokens while preserving exact technical literals.

Changes:

  • Added skills/steno-mode/SKILL.md defining Steno Mode rules, levels, examples, scope, and safety constraints.
  • Updated docs/README.skills.md to include the new skill in the published skills index.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
skills/steno-mode/SKILL.md New skill definition with activation/persistence contract, compression rules, level behaviors, examples, and safety/scope guidance.
docs/README.skills.md Adds the new steno-mode entry to the generated skills README table.

Comment thread skills/steno-mode/SKILL.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 9, 2026 11:47
@github-actions github-actions Bot added new-submission PR adds at least one new contribution skills PR touches skills labels Jul 9, 2026
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

🔍 Vally Lint Results

✅ All checks passed

Scope Checked
Skills 1
Agents 0
Total 1
Severity Count
❌ Errors 0
⚠️ Warnings 0
ℹ️ Advisories 0

Summary

Level Finding
ℹ️ npm warn EBADENGINE Unsupported engine {
ℹ️ npm warn EBADENGINE package: 'commander@15.0.0',
ℹ️ npm warn EBADENGINE required: { node: '>=22.12.0' },
ℹ️ npm warn EBADENGINE current: { node: 'v20.20.2', npm: '10.8.2' }
ℹ️ npm warn EBADENGINE }
ℹ️ npm warn deprecated prebuild-install@7.1.3: No longer maintained. Please contact the author of the relevant native addon; alternatives are available.
ℹ️ ✅ steno-mode (2/2 checks passed)
ℹ️ ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
ℹ️ ✓ spec-compliance: All spec checks passed.
ℹ️ ✓ [valid-refs] All file references across 1 skill(s) are valid.
Full linter output
### Linting skills/steno-mode
npm warn EBADENGINE Unsupported engine {
npm warn EBADENGINE   package: 'commander@15.0.0',
npm warn EBADENGINE   required: { node: '>=22.12.0' },
npm warn EBADENGINE   current: { node: 'v20.20.2', npm: '10.8.2' }
npm warn EBADENGINE }
npm warn deprecated prebuild-install@7.1.3: No longer maintained. Please contact the author of the relevant native addon; alternatives are available.
✅ steno-mode (2/2 checks passed)
    ✓ [spec-compliance] All 1 skill(s) are spec-compliant.
        ✓ spec-compliance: All spec checks passed.
    ✓ [valid-refs] All file references across 1 skill(s) are valid.
        ✓ valid-refs: All file references resolve to existing files within the skill directory.

1 skill(s) linted, 1 passed

@AkashAi7 AkashAi7 changed the title feat: add steno-mode skill for shorthand response compression 🤖🤖🤖 feat: add steno-mode skill for shorthand response compression and token saving Jul 9, 2026
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

🔒 PR Risk Scan Results

Scanned 2 changed file(s).

Severity Count
🔴 High 0
🟠 Medium 1
ℹ️ Info 0
Severity Rule File Line Match
🟠 package-exec-command docs/README.skills.md 31 | [acreadiness-assess](../skills/acreadiness-assess/SKILL.md)&lt;br /&gt;`gh skills install github/awesome-copilot acreadiness-assess` | Run the AgentRC readiness assessment on the curre

This is an automated soft-gate report. Findings indicate review targets and do not block merge by themselves.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

@@ -0,0 +1,105 @@
---
name: steno-mode
description: 'Shorthand-first response compression that cuts ~40% of response tokens while preserving technical precision and exact literals. Use when the user says "steno mode", "shorthand mode", "compressed responses", "token reduction", "brief structured output", or invokes /steno. Supports four compression levels: lite, brief, court, machine. Do not trigger for requests needing polished prose such as docs, tutorials, or customer-facing copy.'
Comment thread docs/README.skills.md
| [sql-optimization](../skills/sql-optimization/SKILL.md)<br />`gh skills install github/awesome-copilot sql-optimization` | Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Provides execution plan analysis, pagination optimization, batch operations, and performance monitoring guidance. | None |
| [sql-server-table-reconciliation](../skills/sql-server-table-reconciliation/SKILL.md)<br />`gh skills install github/awesome-copilot sql-server-table-reconciliation` | Use when: comparing SQL Server tables across instances, data migration validation, ETL verification, row mismatch detection, schema drift, reconciliation report, production vs staging comparison. Uses mssql-python driver with Apache Arrow for fast columnar data transfer and comparison. | `scripts/reconcile.py` |
| [ssma-console](../skills/ssma-console/SKILL.md)<br />`gh skills install github/awesome-copilot ssma-console` | Use when: SSMA console operations — create project, generate assessment report, convert schema, migrate data, Oracle to SQL Server migration, schema conversion, data migration | None |
| [steno-mode](../skills/steno-mode/SKILL.md)<br />`gh skills install github/awesome-copilot steno-mode` | Shorthand-first response compression that cuts ~40% of response tokens while preserving technical precision and exact literals. Use when the user says "steno mode", "shorthand mode", "compressed responses", "token reduction", "brief structured output", or invokes /steno. Supports four compression levels: lite, brief, court, machine. Do not trigger for requests needing polished prose such as docs, tutorials, or customer-facing copy. | None |
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-review:MEDIUM Contributor reputation check flagged MEDIUM risk new-submission PR adds at least one new contribution skills PR touches skills

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants