Skip to content

[docs] Update dictation skill with comprehensive glossary#14469

Merged
pelikhan merged 1 commit intomainfrom
update-dictation-skill-glossary-910ffa576360bd42
Feb 8, 2026
Merged

[docs] Update dictation skill with comprehensive glossary#14469
pelikhan merged 1 commit intomainfrom
update-dictation-skill-glossary-910ffa576360bd42

Conversation

@github-actions
Copy link
Contributor

@github-actions github-actions bot commented Feb 8, 2026

Summary

Updated the dictation skill (skills/dictation/SKILL.md) with a comprehensive glossary of approximately 1000 project-specific technical terms extracted from documentation.

Changes Made

  • Expanded glossary from ~260 to ~1000 terms: Extracted frequently used technical terms from docs/src/content/docs/ (reference, guides, patterns, blog sections)
  • Preserved existing structure: Maintained all speech-to-text error correction instructions, text cleanup guidelines, and examples
  • Focused on project-specific terms: Terms related to gh-aw, workflows, frontmatter, engines, tools, safe-outputs, MCP servers, GitHub Actions, and operational patterns
  • No changes to functionality: Only updated the glossary section; all other sections remain unchanged

Glossary Extraction Process

Terms were extracted from documentation using frequency analysis (3+ occurrences) and filtered to exclude common English words, focusing on:

  • Configuration terms: frontmatter, safe-outputs, permissions, toolsets
  • Engine names: copilot, claude, codex, custom
  • Commands: compile, audit, recompile
  • GitHub concepts: workflow-dispatch, pull-request, issues, discussions
  • Operations patterns: issueops, chatops, dispatchops, etc.
  • Technical terms: sandbox, ephemeral, deterministic, runtime

Quality Improvements

This expanded glossary will help the dictation skill:

  • Better recognize project-specific technical vocabulary
  • More accurately fix speech-to-text errors in gh-aw documentation and discussions
  • Improve consistency in technical term usage across the project

Testing

  • ✅ Verified file has proper SKILL.md frontmatter
  • ✅ Confirmed glossary contains ~1000 terms (1004 lines total in glossary section)
  • ✅ Validated all existing sections preserved (speech-to-text fixes, cleanup guidelines)
  • ✅ Checked terms are alphabetically sorted and project-relevant

References:

AI generated by Dictation Prompt Generator

  • expires on Feb 10, 2026, 6:22 AM UTC

- Extract ~1000 project-specific technical terms from documentation
- Replace existing 260-term glossary with comprehensive term list
- Focus on frequently used terms from reference, guides, and patterns docs
- Maintain existing speech-to-text error correction instructions
- Maintain existing text cleanup and improvement guidelines
- Keep focus on fixing errors, not planning or providing examples
@github-actions github-actions bot added automation documentation Improvements or additions to documentation labels Feb 8, 2026
@pelikhan pelikhan merged commit 324e407 into main Feb 8, 2026
@pelikhan pelikhan deleted the update-dictation-skill-glossary-910ffa576360bd42 branch February 8, 2026 06:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant