[q] fix(dictation): `@copilot`, NLP histogram step, 256-term glossary

[github-actions]

Changes

Improves the dictation prompt generator workflow and skill file based on #28556 feedback.

1. @copilot instead of copilot

All standalone uses of copilot as a project term are now written as @copilot in:

• The 256-term glossary in skills/dictation/SKILL.md
• The speech-to-text correction rule: "co-pilot" → @copilot``
• The workflow instructions in .github/workflows/dictation-prompt.md

2. Python NLP word-frequency histogram (new precomputed step)

Added a new Step 1 to dictation-prompt.md that runs a Python script before any agent reasoning:

# Extracts identifier-like tokens from docs/src/content/docs/**/*.md
# `@mentions`, ALL_CAPS, camelCase, kebab-case, snake_case
# Writes top-512 by document frequency to /tmp/word-frequencies.json

The agent then uses this histogram as the primary source for term selection, ensuring the glossary reflects actual documentation vocabulary rather than manual guessing.

3. 256-term limit (down from ~1000)

• Glossary trimmed from ~1000 terms to exactly 256 high-frequency project-specific terms
• Terms selected using the NLP frequency histogram + domain curation
• Success criteria in the workflow updated accordingly

Files changed

File	Change
.github/workflows/dictation-prompt.md	Added NLP step, @copilot instructions, 256-term target
skills/dictation/SKILL.md	256-term glossary, @copilot everywhere standalone copilot appeared

---

Warning

Protected Files — Push Permission Denied

This was originally intended as a pull request, but the patch modifies protected files. A human must create the pull request manually.

Protected files

• .github/workflows/dictation-prompt.md

The push was rejected because GitHub Actions does not have workflows permission to push these changes, and is never allowed to make such changes, or other authorization being used does not have this permission.

Create the pull request manually

# Download the patch from the workflow run
gh run download 24953902997 -n agent -D /tmp/agent-24953902997

# Create a new branch
git checkout -b update-dictation-skill-4d76b6f27a5fdc8f-acd1731abd130a0d main

# Apply the patch (--3way handles cross-repo patches)
git am --3way /tmp/agent-24953902997/aw-update-dictation-skill-4d76b6f27a5fdc8f.patch

# Push the branch and create the pull request
git push origin update-dictation-skill-4d76b6f27a5fdc8f-acd1731abd130a0d
gh pr create --title '[q] fix(dictation): `@copilot`, NLP histogram step, 256-term glossary' --base main --head update-dictation-skill-4d76b6f27a5fdc8f-acd1731abd130a0d --repo github/gh-aw

🎩 Equipped by Q · ● 2.4M · ◷

• expires on Apr 28, 2026, 10:10 AM UTC