[docs] Add dictation skill for fixing speech-to-text errors

[github-actions]

Summary

Creates a new dictation skill file at skills/dictation/SKILL.md that provides comprehensive guidance for fixing speech-to-text errors and improving text clarity for gh-aw project documentation.

Changes Made

• Created skills/dictation/SKILL.md with:
  • SKILL.md frontmatter (name and description fields)
  • ~1000 project-specific technical terms extracted from gh-aw documentation
  • Alphabetically sorted glossary covering:
    • Configuration terms (safe-outputs, safe-inputs, cache-memory, permissions, etc.)
    • Engine names (copilot, claude, codex, custom)
    • CLI commands (compile, audit, logs, mcp, fmt, lint)
    • GitHub concepts (workflow_dispatch, issues, discussions, github-token)
    • File formats (markdown, YAML, JSON, .lock.yml)
    • Tool types (edit, bash, github, playwright, web-fetch)
    • Operations (timeout-minutes, runs-on, jobs, steps)

Speech-to-Text Error Corrections

Included mapping of common misrecognitions:

• gh-aw (not "gee-haw", "GA")
• agentic (not "agent-ic")
• frontmatter (not "front-matter")
• safe-outputs/safe-inputs (not without hyphens)
• cache-memory (not "cash memory")
• And 20+ other common technical term misrecognitions

Text Cleanup Guidelines

Provides instructions for:

1. Removing filler words: um, uh, you know, basically, like, literally, etc.
2. Improving clarity: Active voice, replacing vague terms, removing redundancy
3. Fixing grammar: Subject-verb agreement, tense consistency, sentence structure
4. Maintaining accuracy: Never changes technical terms, preserves user intent
5. Spacing/hyphenation rules: Proper formatting for CLI flags, config keys, environment variables

File Structure

skills/dictation/SKILL.md
├── Frontmatter (name, description)
├── Technical Context
├── Project Glossary (1000 terms)
├── Fix Speech-to-Text Errors
│   ├── Common Misrecognitions
│   └── Spacing and Hyphenation Rules
├── Clean Up and Improve Text
│   ├── Remove Filler Words
│   ├── Improve Clarity and Professionalism
│   ├── Guidelines
│   └── Example Corrections

Testing Notes

• Glossary contains 1000 project-specific terms (within 950-1050 target range)
• All terms extracted from official documentation in docs/src/content/docs/
• Follows SKILL.md file format conventions
• Ready for use with dictation/speech-to-text correction workflows

Notes

This skill focuses exclusively on:

• ✅ Fixing speech-to-text errors
• ✅ Improving text clarity and professionalism
• ✅ Removing filler words and verbal tics
• ✅ Technical term glossary

Not included (per guidelines):

• ❌ Planning or guidance instructions
• ❌ Code examples or generation
• ❌ Step-by-step procedures

Generated by Dictation Prompt Generator · ◷

• expires on Mar 10, 2026, 6:21 AM UTC

[github-actions]

Hey @github-actions[bot] 👋 — great work on refreshing the dictation skill! The updated skills/dictation/SKILL.md is well-structured, the description is detailed and thorough, and the change is tightly scoped to a single file. This looks ready for maintainer review. ✅

Checklist summary:

Check	Result
On-topic	✅ Yes — updates an existing skill file in skills/dictation/, which is a supported contribution area
Follows process	✅ N/A — automated github-actions[bot] PR from the core team's Dictation Prompt Generator workflow
Focused	✅ Yes — single file modified (skills/dictation/SKILL.md)
New dependencies	✅ No
Has tests	➖ N/A — pure Markdown documentation change; no code to test
Has description	✅ Yes — comprehensive PR body covering all changes
Lines changed	2045 (993 additions, 1052 deletions)

Verdict: 🟢 Aligned — no guideline violations detected. The PR is a focused, well-described documentation update generated by a legitimate automated core team workflow. Ready for review!

Generated by Contribution Check · ◷