From 809c43ce075871657e0aa68adf5a85dd25d3db31 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sun, 28 Dec 2025 06:09:47 +0000
Subject: [PATCH] Update dictation skill with comprehensive glossary from
 documentation

- Extracted 412 project-specific terms from docs/src/content/docs/
- Organized glossary alphabetically for easy reference
- Added comprehensive speech-to-text error corrections table
- Included spacing/hyphenation rules for common patterns
- Enhanced frontmatter metadata with proper name and description
- Added clear instructions to focus on error correction only
---
 skills/dictation/SKILL.md | 606 +++++++++++++++++++++++++++++++-------
 1 file changed, 494 insertions(+), 112 deletions(-)

diff --git a/skills/dictation/SKILL.md b/skills/dictation/SKILL.md
index d7e4d72557..e60084b8d5 100644
--- a/skills/dictation/SKILL.md
+++ b/skills/dictation/SKILL.md
@@ -1,246 +1,628 @@
 ---
-name: dictation
-description: Fix speech-to-text errors in gh-aw documentation and code
+name: Dictation Instructions
+description: Fix speech-to-text errors in dictated text using project-specific vocabulary from GitHub Agentic Workflows
 ---
 
-
 # Dictation Instructions
 
-Fix text-to-speech errors in dictated text for creating agentic workflow prompts in the gh-aw repository.
+Fix speech-to-text errors in dictated text for GitHub Agentic Workflows (gh-aw), a GitHub CLI extension that transforms natural language markdown files into GitHub Actions.
+
+## Technical Context
+
+GitHub Agentic Workflows (gh-aw) is a Go-based GitHub CLI extension for writing agentic workflows in natural language using markdown files, running them as GitHub Actions.
 
 ## Project Glossary
 
-The following terms are specific to this project and should be recognized and used correctly:
+Correct ambiguous speech-to-text transcriptions using these project-specific terms:
 
+actionlint
 activation
 add-comment
 add-labels
 add-reviewer
+agent
+agent-finish
 agentic
 agentic-workflows
-agent
-agent-files
+allowed-domains
+allowed-exts
+anthropic
+api-github-com
+api-url
+approval-gates
+args
+artifacts
 assign-milestone
 assign-to-agent
 assign-to-user
+assignees
+async
 audit
+authentication
 auto-expiration
+auto-merge-prs
 bash
+bash-tool
+boolean
+bootstrap
+branch
+cache
+cache-id
 cache-memory
 campaign
+campaign-id
+campaigns
+changelog
 chatops
+checkout
+ci-doctor
+claude
+claude-sonnet
+cli
 close-discussion
 close-issue
 close-pull-request
+codebase
 codex
+codemods
+code-scanning
+code-scanning-alert
+command-line
+command-triggers
+commit-sha
+CommonJS
 compile
+compiler
+completion
 concurrency
+config
+configuration
+context
+container
+containerized
+contents
 copilot
+copilot-cli
+copilot-github-token
+copilot-model
 create-agent-task
 create-code-scanning-alert
 create-discussion
 create-issue
 create-pull-request
-cron
+create-pull-request-review-comment
 cross-repository
-custom-agents
+cron
+cross-prompt-injection
+cursor-glob
+custom-agent
+custom-engine
+custom-mcp
+custom-safe-outputs
+cyclonedx
 dailyops
-domains
+dashboard
+debian
+debugging
+default
+defaults
+dependabot
+deprecated
+description
+deterministic
+dev-hawk
+development
+dictionary
+discussion
+discussion-comment
+discussions
+dispatchops
+docker
+docker-hub
+dockerfile
+domain
+dotnet
 draft
 ecosystem
 edit
+edit-tool
+emoji
+enabled
+endpoint
 engine
+enum
+environment
 environment-variables
+error-patterns
+event
+event-type
 expires
+expressions
+extensions
+feature-flags
 features
+fetch
+file-path
+file-size
+filter
+fine-grained
 firewall
+fix
 fork
 forks
+format
 frontmatter
+fuzz-tests
 fuzzy
+gh
 gh-aw
+gh-aw-agent-token
+gh-aw-firewall
+gh-aw-github-token
+gh-aw-project-github-token
+gh-cli
 github
+github-actions
+github-actions-secret
+github-app
+github-cli
+github-copilot
+github-enterprise
+github-mcp
+github-script
+github-server-url
 github-token
+github-tokens
+githubnext
+gitignore
+glob
 glossary
+go
+golang
+gpt
+graphql
+handlebars
+hashicorp
+haskell
+header
 hide-comment
+hide-older-comments
+hosted
+hostname
+http
+https
+identifier
 if-no-changes
 imports
+init
+inline
+inputs
+inspector
+install
+integration
 issue
 issue-comment
-issue_comment
+issue-tracking
 issueops
+java
+javascript
+job
+job-outputs
+json
+json-schema
+jq
+kb
+kpi
+label
+labelops
 labels
+language
+launcher
+legacy
+levenshtein
+lifecycle
+line-endings
+line-length
 link-sub-issue
-lockdown
+lint
+linter
+linux
+list
+lock-file
 lockfile
+lock-yml
 log-level
 logs
+maintainer
+maintenance
+makefile
+manual-approval
 markdown
+max
+max-discovery-items-per-run
+max-discovery-pages-per-run
 max-patch-size
+max-size
 mcp
+mcp-gateway
 mcp-server
 mcp-servers
+memory
+merge
 metadata
+milestone
 minimize-comment
 missing-tool
-monthly
+model
+model-context-protocol
+mode
+monitoring
+multi-edit
+multi-repo
+multirepoops
 network
+network-permissions
+node
+nodejs
 noop
+normalization
 npm
+npm-registry
 npx
+number
+off-topic
+on
+operations
+optional
+orchestrator
+org
+organization
+orphaned
+outdated
+output
+outputs
+owner
+package
+packaging
+pagination
+parallel
+parameter
+parent-issue
+parse
+pat
+patch
+path
+pattern
+payload
+perl
+permission
 permissions
+personal-access-token
+php
 pip
 playwright
+plugin
+post-steps
+poutine
+preview
+priority
+private-key
+process
+project
+project-management
+projectops
+projects-v2
+prompt
+prompt-injection
+public
 pull-request
-pull_request
+pull-request-review-comment
+pull-requests
+purge
+push
 push-to-pull-request-branch
+py
 pypi
+python
+pythonhosted
+query
+quick-start
+raw-githubusercontent
 reaction
+read-all
 read-only
+readme
 recompile
+redacted
+ref
+refactoring
+regex
+registry
+release
+remote
+removal
+remove
+repeat
+repo
 repo-memory
+repository
+request
+required
+research
+researchplanassign
+resolved
+resource
+reviewers
+roadmap
+role
 roles
+run
+run-failure
+run-id
+run-name
+run-started
+run-success
+runbook
+runner
 runs-on
+runtime
+rust
+safe
 safe-inputs
+safe-output
+safe-output-messages
 safe-outputs
+sandbox
+sanitization
 sanitize
 sarif
 sbom
+scan
+scanner
+schema
+schedule
 scheduled
+scope
+script
+search
+secret
 secrets
+security
+self-hosted
+semantic
+separator
+service
+session
+session-id
+setup
+sha
+shell
+shorthand
+siderepoops
+single-select
+skillz
+skip-if-match
+slash
 slash-command
+slug
+spdx
+ssh
+sse
 staged
+staged-mode
 status
+step
+steps
+stop-after
 strict
+strict-mode
+string
 sub-issue
+subdomain
+submodule
+subprocess
+success
+summary
+swift
+sync
+syntax
+target
+target-repo
+task
+template
+templating
+temporary
+temporary-id
+terraform
+test
+test-unit
+testing
+threat-detection
+throttle
+timeout
 timeout-minutes
+title-prefix
+token
+tool
 toolset
 toolsets
+trace
 tracker-id
+tracking
+trigger
+triggering
+triage
 trial
-triggers
+trialops
+troubleshooting
+typescript
+ubuntu
+ubuntu-latest
+ubuntu-slim
+ui
+update
 update-issue
 update-project
 update-pull-request
 update-release
+upload
 upload-asset
+url
+user
+username
+utf
+utc
+validate
+validation
+validator
+value
+variable
+verbose
+version
+vscode
+vulnerability
+watch
 web-fetch
 web-search
-weekly
+webhook
+whitespace
+wildcard
+workflow
 workflow-dispatch
 workflow-run
-workflow_run
 workflows
+workspace
+write
+write-all
+xml
+yaml
+yarn
+zizmor
 
-## Technical Context
+## Fix Speech-to-Text Errors
 
-GitHub Agentic Workflows (gh-aw) - a Go-based GitHub CLI extension for writing agentic workflows in natural language using markdown files with YAML frontmatter, which compile to GitHub Actions workflows.
+### Common Misrecognitions
 
-## Fix Speech-to-Text Errors
+Correct these frequent speech-to-text errors:
 
-Replace speech-to-text ambiguities with correct technical terms from the glossary:
+| Misrecognized | Correct |
+|--------------|---------|
+| G H | gh |
+| G H A W | gh-aw |
+| ghaw | gh-aw |
+| gee awe | gh-aw |
+| get hub | github |
+| get hub actions | GitHub Actions |
+| git hub | GitHub |
+| agent ick | agentic |
+| agent tick | agentic |
+| agentive | agentic |
+| M C P | MCP |
+| em see pee | MCP |
+| model context protocol | Model Context Protocol |
+| cop pilot | Copilot |
+| co-pilot | Copilot |
+| play right | Playwright |
+| play write | Playwright |
+| front matter | frontmatter |
+| lock file | lockfile |
+| lock dot Y M L | lock.yml |
+| dot lock dot Y M L | .lock.yml |
+| dot M D | .md |
+| Y A M L | YAML |
+| J S O N | JSON |
+| mark down | markdown |
+| git ignore | gitignore |
+| dot git ignore | .gitignore |
+| safe inputs | safe-inputs |
+| safe outputs | safe-outputs |
+| work flow | workflow |
+| work flows | workflows |
+| tool set | toolset |
+| tool sets | toolsets |
+| time out | timeout |
+| check out | checkout |
+| cache memory | cache-memory |
+| repo memory | repo-memory |
+| cross repo | cross-repository |
+| P R | PR |
+| pull request | pull request |
+| issue ops | issueops |
+| label ops | labelops |
+| chat ops | chatops |
+| daily ops | dailyops |
+| project ops | projectops |
+| multi repo | multi-repo |
+| campaign dot M D | .campaign.md |
+| dot campaign dot M D | .campaign.md |
+| slash command | slash_command |
+| work flow dispatch | workflow_dispatch |
+| workflow run | workflow_run |
+| issue comment | issue_comment |
+| on colon | on: |
+| permissions colon | permissions: |
+| tools colon | tools: |
+| SAR IF | SARIF |
+| es bom | SBOM |
+| NPM JS | npmjs |
+| NPX | npx |
+| pi pi | pypi |
 
-- "ghaw" → "gh-aw"
-- "G H A W" → "gh-aw"
-- "G H dash A W" → "gh-aw"
-- "gee awe" → "gh-aw"
-- "work flow" → "workflow"
-- "work flows" → "workflows"
-- "front matter" → "frontmatter"
-- "lock file" → "lockfile" or "lock-yml"
-- "co-pilot" → "copilot"
+### Spacing and Hyphenation
+
+Fix common spacing and hyphenation errors:
+
+**Add hyphens:**
 - "safe inputs" → "safe-inputs"
 - "safe outputs" → "safe-outputs"
 - "cache memory" → "cache-memory"
 - "repo memory" → "repo-memory"
-- "max turns" → "max-turns"
-- "max concurrency" → "max-concurrency"
-- "max patch size" → "max-patch-size"
-- "issue comment" → "issue-comment"
-- "pull request" → "pull-request"
-- "pull request comment" → "pull-request-comment"
-- "pull request review comment" → "pull-request-review-comment"
-- "workflow dispatch" → "workflow-dispatch"
-- "work flow dispatch" → "workflow_dispatch"
+- "time out minutes" → "timeout-minutes"
 - "runs on" → "runs-on"
 - "run name" → "run-name"
-- "timeout minutes" → "timeout-minutes"
-- "allowed domains" → "allowed-domains"
-- "title prefix" → "title-prefix"
-- "target repo" → "target-repo"
-- "read only" → "read-only"
-- "if no changes" → "if-no-changes"
-- "retention days" → "retention-days"
-- "stop after" → "stop-after"
-- "web fetch" → "web-fetch"
-- "web search" → "web-search"
-- "test unit" → "test-unit"
-- "post steps" → "post-steps"
-- "M C P" → "MCP"
-- "em see pee" → "MCP"
-- "MCP servers" → "mcp-servers"
-- "MCP server" → "mcp-server"
-- "MCP config" → "mcp-config"
-- "git hub" → "github"
-- "git hub token" → "github-token"
-- "agentive" → "agentic"
-- "agent ick" → "agentic"
-- "agent tick" → "agentic"
-- "label ops" → "labelops"
-- "issue ops" → "issueops"
-- "chat ops" → "chatops"
-- "project ops" → "projectops"
-- "daily ops" → "dailyops"
-- "NPM JS" → "npmjs"
-- "NPX" → "npx"
-- "pi pi" → "pypi"
-- "pip" → "pip"
-- "SAR IF" → "SARIF"
-- "SARIF" → "SARIF"
-- "SBOM" → "SBOM"
-- "es bom" → "SBOM"
-- "create agent task" → "create-agent-task"
-- "create code scanning alert" → "create-code-scanning-alert"
-- "create discussion" → "create-discussion"
+- "add comment" → "add-comment"
 - "create issue" → "create-issue"
-- "create pull request" → "create-pull-request"
-- "create pull request review comment" → "create-pull-request-review-comment"
-- "push to pull request branch" → "push-to-pull-request-branch"
-- "update issue" → "update-issue"
-- "update project" → "update-project"
-- "update pull request" → "update-pull-request"
-- "update release" → "update-release"
-- "upload asset" → "upload-asset"
-- "close discussion" → "close-discussion"
 - "close issue" → "close-issue"
-- "close pull request" → "close-pull-request"
-- "hide comment" → "hide-comment"
-- "minimize comment" → "minimize-comment"
-- "missing tool" → "missing-tool"
-- "add comment" → "add-comment"
-- "add labels" → "add-labels"
-- "add reviewer" → "add-reviewer"
-- "assign milestone" → "assign-milestone"
-- "assign to agent" → "assign-to-agent"
-- "assign to user" → "assign-to-user"
-- "link sub issue" → "link-sub-issue"
-- "sub issue" → "sub-issue"
-- "discussion comment" → "discussion-comment"
-- "issue comment" → "issue-comment" or "issue_comment"
-- "pull request" → "pull-request" or "pull_request"
-- "skip if match" → "skip-if-match"
-- "manual approval" → "manual-approval"
-- "log level" → "log-level"
-- "workflow run" → "workflow_run"
-- "tracker ID" → "tracker-id"
-- "custom agents" → "custom-agents"
-- "agent files" → "agent-files"
-- "slash command" → "slash-command" (in frontmatter)
-- "environment variables" → "environment-variables"
-- "auto expiration" → "auto-expiration"
+- "update project" → "update-project"
+- "title prefix" → "title-prefix"
+- "max size" → "max-size"
+- "allowed domains" → "allowed-domains"
 - "cross repository" → "cross-repository"
+- "pull request" → "pull-request" (when used as compound modifier)
+- "issue comment" → "issue-comment" (when used as compound modifier)
+- "read only" → "read-only"
+- "write all" → "write-all"
+- "fine grained" → "fine-grained"
+- "code scanning" → "code-scanning"
+
+**Remove spaces:**
+- "front matter" → "frontmatter"
+- "work flow" → "workflow"
+- "lock file" → "lockfile"
 - "tool set" → "toolset"
-- "tool sets" → "toolsets"
+- "check out" → "checkout"
+- "mark down" → "markdown"
+- "git ignore" → "gitignore"
+
+**Preserve underscores:**
+- "workflow_dispatch" (not "workflow-dispatch")
+- "slash_command" (not "slash-command")
+- "pull_request" (not "pull-request" in YAML context)
+- "issue_comment" (not "issue-comment" in YAML context)
+- "workflow_run" (not "workflow-run" in YAML context)
+
+## General Instructions
+
+When fixing dictated text:
+
+1. **Preserve original intent**: Only fix clear speech-to-text errors
+2. **Use project glossary**: Prefer terms from the glossary above
+3. **Fix capitalization**: "github" → "GitHub", "copilot" → "Copilot"
+4. **Maintain YAML formatting**: Preserve colons, indentation, structure
+5. **Context matters**: "pull request" vs "pull-request" vs "pull_request" depends on usage
+6. **Keep code intact**: Don't modify working code examples unless clearly wrong
+
+Focus solely on correcting transcription errors - do not add explanations, examples, or planning steps.
 
 ## Guidelines