From a1e7152eaf46d610cc77eb0cc9af9abef8678179 Mon Sep 17 00:00:00 2001 From: Copilot Date: Sun, 8 Mar 2026 06:18:27 +0000 Subject: [PATCH] feat: Add dictation skill for fixing speech-to-text errors - Create skills/dictation/SKILL.md with 1000 project-specific terms - Include glossary extracted from gh-aw documentation - Add common speech-to-text error mappings for technical terms - Provide guidelines for removing filler words and improving text clarity - Include spacing and hyphenation rules for project conventions Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- skills/dictation/SKILL.md | 2045 ++++++++++++++++++------------------- 1 file changed, 993 insertions(+), 1052 deletions(-) diff --git a/skills/dictation/SKILL.md b/skills/dictation/SKILL.md index 0c5b790d070..5207a38176f 100644 --- a/skills/dictation/SKILL.md +++ b/skills/dictation/SKILL.md @@ -1,1158 +1,1099 @@ --- name: Dictation Instructions -description: Instructions for fixing speech-to-text errors and improving text quality in gh-aw documentation and workflows +description: Fix speech-to-text errors and improve text clarity for gh-aw documentation --- # Dictation Instructions ## Technical Context -GitHub Agentic Workflows (gh-aw) is a Go-based GitHub CLI extension for writing AI-powered workflows in natural language using markdown files that compile to GitHub Actions YAML. +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. This glossary helps fix speech-to-text errors for project-specific terminology. ## Project Glossary -The following project-specific technical terms should be corrected when encountered in speech-to-text input: - -.github -.github/agents -.github/aw -.github/aw/imports -.github/workflows -.lock.yml -.md -@copilot +--actionlint +--agent +--allow-domains +--allow-empty +--append +--arg +--audit +--auto-merge-prs +--autopilot +--body +--clone-repo +--codespaces +--completions +--config +--create-pull-request +--days +--delete-host-repo-after +--dependabot +--dir +--disable-release-bump +--dry-run +--engine +--fail-fast +--fix +--force +--force-delete-host-repo-before +--host-repo +--hostname +--json +--label +--limit +--link +--list-codemods +--logical-repo +--major +--max-autopilot-continues +--network +--no-emit +--no-fix +--no-mcp +--no-merge +--non-interactive +--only-verified +--orphan +--output +--owner +--package-lock-only +--parse +--port +--poutine +--private +--purge +--push +--raw-field +--ref +--registry +--repeat +--repo +--rm +--run-id +--server +--start-date +--state +--strict +--threshold +--title +--tool-id +--transport +--trigger-context +--validate +--validate-actor +--value +--value-from-env +--verbose +--wait +--watch +--write +--yes +--zizmor +-1 +-1w +-32000 +-32001 +-32002 +-32003 +-32600 +-32601 +-32602 +-32603 +-32700 +-av +-b +-c +-d +-euo +-exec +-f +-h +-i +-k +-m +-n +-p +-q +-r +-rf +-s +-sl +-type +-v +-x +-y +0-23 +0-59 +0-6 +00-59 +1-12 +1-2 +1-3 +1-31 +1-5m +1-64 +1-90 +1-day +10-100x +10-200 +10-30s +10-second +100-200 +11am-1pm +12-hour +120-minute +15-30 +19-part +2-3 +2-4 +2-6 +20-40 +200-500 +2026-01-12 +2026-01-21 +2026-01-24 +2026-01-27 +2026-01-30 +2026-02-02 +2026-02-05 +2026-02-18 +24-hour +2pm-10pm +2pm-4pm +3-4 +3-5 +3-phase +3-way +30-day +32-bit +4-32 +4-6 +4pm-6pm +5-15 +5-field +5-minute +5-second +7-day +8-10 +8am-10am +90-day +9am-5pm +_more +a +a11y +aa +abandoned +abbreviation +abbreviations +ability +able +abnf +abort-on-error +about +above +absence +absent +absolute +absolutely +abstract +abstraction +abuse +academic +accelerated +accept +accept-header +acceptance +accepted +accepting +accepts access +accesses +accessibility accessible +accessing +accidental +accidentally +accommodate +accommodates +accomplish +according +account +accounted +accounts +accumulate +accumulated +accumulation +accuracy +accurate +achieve +achieves +achieving +acknowledge +acknowledgment +acomprehensive +across +act +acting action -action-mode -action-pins.json -action-repo -action-version +action-dispatch +action-friendly +action-inputs +action-oriented +action-outputs +action-secrets +action-workflow +actionable actionlint actions -actions-read -actions/cache -actions/checkout -actions/github-script -actions/setup-dotnet -actions/setup-go -actions/setup-java -actions/setup-node -actions/setup-python +actions-all +activate +activate-environment +activates activation active +actively +activity actor +actor-permissions +actors +acts actual +actually +ad-hoc +adapt +adaptations +adapting +adaptive +adapts +add add-comment -add-labels -add-reviewer +add-to-project add-wizard -additional add_comment add_labels +add_reviewer +added +adding +addition +additional +additionally +additions +address +addressed +addresses +addressing +adds +adequate +adherence +adhoc +adjust +adjusted +adjustment admin -after_run_id +administrator +administrators +admins +admirable +adopt +adoption +adopts +advanced +advanced-features +adversarial +adversarially-crafted +adversary +advice +advisories +advisory +advocate +affect +affected +affecting +affects +afraid +after +afternoon +against +age +agency +agency-the +agent +agent-action +agent-declared +agent-dispatch +agent-engine +agent-failure +agent-id +agent-output +agent-prompt +agent-provided +agent-ready +agent-session +agent-specific +agent-status +agent-task +agent-to-processor +agent-to-server +agent-token +agent_out agentic +agentic-chat agentic-workflows +agentically agentics +agentoutput agents -agent_output.json -alerting +aggregate +aggregated +aggregates +aggregating +aggressive +agile-methodology +ahead +ai +ai-assistant +ai-assisted +ai-based +ai-driven +ai-engine +ai-enriched +ai-generated +ai-model +ai-optimized +ai-powered +ai-to-github +aim +alert alerts +algorithm +algorithmically +algorithms +alias +aliases +align +aligned +all +all-or-nothing +allocated +allocation allow allowed +allowed-aliases allowed-domains -allowed-extensions allowed-github-references -allowed-labels -allowed-pull-request-repos -allowed-reasons allowed-repos +allowed_github_references +allowed_out +allowed_repos +allowedlabels +allowing allowlist +allowlisted +allowlisting +allowlists +allows +almost +alone +along +alongside +aloud +alpha +alphabetical +alphabetically +alphanumeric +alpine +already +already-locked +also +alt +alter +altering +alternative +alternatively +alternatives +although +always +always-on +am +am-5 +am-pm +amazing +ambient +ambiguity +ambiguous +ambitious +an +analyses analysis -ANTHROPIC_API_KEY -api.github.com -apiKey +analysis-results +analyst +analysts +analytical +analytics +analyze +analyzed +analyzer +analyzes +analyzing +anatomy +and +android +angle +annotations +announcement +announcement-capable +announcements +anomalies +anomaly +anonymized +another +ansi +answer +answers +anthropic +anthropic_api_key +anti-patterns +anticipate +any +anyone +anything +anywhere +apart +api +api-gateway +api-rate-limit +api-response +api-timeout +api_error +api_key +api_secret +apikey +apis +apm +app +app-secret +app_id +app_private_key +appear +appeared +appearing +appears append -append-only-comments +append-only +appended +appendices +appendix +appends +applicable +application +applications +applied +applies apply +applying +approach +approaches +appropriate +appropriately approval -archie +approval-workflow +approvals +approve +approved +approves +approximate +approximately +apps +apt-get +arbitrarily +arbitrary +arborist +arc +architectural architecture +architectures +archival +archive +archived +archiving +are +areactivated +areas args +argument +arguments +aria +arise +arithmetic +arm64 +around +around-constraint array +arrays +arrived +art +article +articles +articulate artifact +artifact-based +artifact-cache +artifact-retention +artifact-upload +artifact_storage artifacts +as +as-is +aside +ask +ask_question +asked +asking +asks +aspects +assembles +assertions +assess +assessing +assessment +asset +assets assign -assign-milestone -assign-to-agent -assign-to-bot -assign-to-user +assign_milestone +assign_to_agent +assign_to_user +assigned assignee assignees +assigning assignment -ast-grep +assignments +assigns +assistance +assistant +associated +associates +association +assume +assuming +assumptions +assurance +asterisks +async +async-operation +asynchronous +at +atomic +atomicity +attach +attack +attacker +attackers +attacks +attempt +attempted +attempting +attempts +attention +attestations +attracts +attributed +attributes +attribution audit -audit-workflows +auditable +auditing +auditor audits +audti-workflows +augments auth +auth-handler +auth-method +auth-token +authenticate +authenticated +authenticates +authenticating authentication author -autofix-code-scanning-alert +authored +authoring +authority +authorization +authorized +authorizing +authors +auto +auto-access +auto-adds +auto-append +auto-apply +auto-assign +auto-close +auto-closes +auto-commit +auto-configures +auto-create +auto-created +auto-deleted +auto-detect +auto-detects +auto-expiration +auto-expiring +auto-fix +auto-generated +auto-injected +auto-labels +auto-linking +auto-merge +auto-recompile +auto-release +auto-remediation +auto-request +auto-requests +auto-resolves +auto-sanitization +auto-saves +auto-suggests +auto-triage +auto-update +autofix +autofix_code_scanning_alert +autofixes +automate automated +automated-action +automated-build +automated-deploy +automated-merge +automated-test +automates automatic +automatic-action +automatic-deployment +automatic-release +automatic-retry +automatically +automatically-revoked +automating automation -automation-enabled +automation-trigger +autonomous +autopilot availability -aw-patch -aw.patch +available +avatar +avatar-url +avoid +avoiding +avoids +aw +aw-agent-output +aw-agent-token +aw-ci-trigger +aw-cross-repo +aw-main-repo +aw-project-token +aw_audit +aw_logs +aw_status +aw_xxxxxxxxxxxx +await +awaited +awareness +away awf -AWF_HOST_PATH +awf-specific +aws +axe-core +azure +b +back +backend +backends background +backing +backlinks +backlog +backseat +backstop +backticks +backup +backups +backward +backward-compatible +backward-incompatible +backwards-incompatible +bad +badges +balance +balancing +bandwidth banner +bare +base base-branch +base64-encoded +based +baseline +baseline-metric +baselines +bases +baseurl bash -before_run_id +basic +basically +batch +batch-job +batch-process +batching +battle-tested +be +bearer +beast +beats +beautiful +became +because +become +becomes +been +before +before-merge +before-release +begin +beginning +begins +behave +behaves +behavior +behavior-tracking +behavioral +behaviors +behaviour +behind +being +belong +belonging +belongs +below +benchmark-test +benchmarks +benefit +benefits +best +best-effort +best-practice +beta +better +between +between-constraint +beyond +bfs bi-weekly -blob +bidirectional +big +bigger +bill +billed +billing +binaries +binary +binary-artifact +binds +birthday +bit +black +blame +blast +block blocked +blocked_out +blocking +blocks +blog +bloglinksection +blogs +blueprints +bnf board boards +bodies body +body-only +bogged +boilerplate +bond +bookmark boolean -boolean-field +booleans +boost +bootstrap +bot +bot-to-bot +both +bots +bouncer +bound +boundaries +boundary +bounded +bounds branch -branch-name +branch-based +branch-delete +branch-merge +branch-policy branch-prefix +branch-protect +branch-rename branches -branch_name +branding +brave +breadth-first +break +break-glass +breakage +breakdown breaking breaking-change -breaking-change-checker +breaks +bridge +brief +bring +bringing +brings +broad +broader +broke +broken brotli +brought +browse +browser +browser-based +browsers +budget +buffer +buffered +buffering bug +buggy +bugs build +build-action +build-artifact +build-cache +build-config +build-deploy +build-error +build-log +build-matrix +build-output +build-retry +build-status +build-time +build-timeout +build-trigger +build-wasm +building builds -bun +built +built-in +bulk +bulk-action +bulk-label +bump +bumps +bundle +bundled +bundler +bundles +bundling +burden +burner +burst +business +but +button +by +bypass +bypassed +bypassing +byte +bytes +c cache +cache-action +cache-based +cache-cleanup +cache-config +cache-hit cache-key cache-memory +cache-miss +cache-restore +cache-save +cache-size +cache_restore +cache_save cached caches +caching +calculate +calculate-hash +calculated +calculations +call +call-webhook +callable +callback +called +callee +caller +callers +calling +calls +came +campaigns +can +cancel +cancel-deployment +cancel-in-progress +cancel-job +cancel-workflow +canceling +cancellation +cancellations +cancelled +cancels +candidate +candy +cannot +canonical +cap capabilities +capability +capability-check +capable capture +capture-output +captured +captures +capturing +cardgrid +cards +careful +carefully +caretakers +cargo-cult +cascades +cascading +case +case-insensitive +cases +casual +cat +catalog +catch +catch-error +catch-up +catches +catching +categories +categorization +categorize +categorizes +categorizing category category-filter -changes -characters -chart -charts -charts-with-trending -chatops -checkout -checks -choice -ci-doctor -ci-failure-doctor -claude -CLAUDE_CODE_OAUTH_TOKEN -cleanup -close-discussion -close-issue -close-older-issues -close-pull-request -closed -close_older -cluster -code-scanning -codex -coding -coding-agent -collaboration -collection -command -commands -comment -comment-body -comment-thread -comment_id -comment_repo -commit -commit-changes -commits -compile -compile-time -compile-workflow -compiled -compiled_file -compiler -compileWorkflow -completion -compliance -component -component-spec -components -conclusion -conclusion-check -concurrency -config -configuration-file -configurations -configure -configured -conflicts -connection -console -constraints -container -container.env -containerized -containers -content -content-security -content.message -content.path -content.size -content.type -contents -context -context-variable -contributors -control -copilot -copilot-pr-data-fetch -copilot-pr-nlp-analysis -copilot-requests -copilot-session-insights -copilot-swe-agent -COPILOT_GITHUB_TOKEN -copy-from -core -count-limit -coverage -create-agent-session -create-code-scanning-alert -create-discussion -create-issue -create-project -create-project-status-update -create-pull-request -create-pull-request-review-comment -create_discussion -create_fields -create_issue -create_project -create_pull_request -create_pull_request_review_comment -create_views -created_issue_number -created_issue_url -created_pr_number -created_pr_url -creation -credentials -criteria -cron -cross-repo -cross-repository -custom -custom-agent -customSchemas -customServerConfig -daily -daily-accessibility-review -daily-backlog-burner -daily-file-diet -daily-ops -daily-perf-improver -daily-qa -daily-repo-status -daily-secrets-analysis -daily-team-status -daily-test-improver -daily-workflow-updater -dart -data-analysis -data-ops -database -datadog -date -day-of-week -days -debug -debug-logging -deep -deepwiki -default -default-branch -defaults -definition -definitions -delete_symbol -demand -deno -dependabot -dependencies -deploy -deploy-app -deploy-preview -deployment -deployment-check -deployments -description -description-field -destination -details -detection -devcontainer.json -development -directory -disable -disabled -discussion -discussions -discussion_comment -discussion_number -dispatch -dispatch-ops -dispatch-workflow -dispatched -dispatching -docker -documentation -domains -dotnet -download -downloaded_files -downstream -draft -duplicate -duplicate-code-detector -echo-command -ecosystem -edit -elixir -empty -enabled -encoding/json -endpoints -end_date -enforce -enforcement -engine -engine-config -engine.concurrency -engine.env -engines -entity -entrypoint -entrypointArgs -environment -environment-variables -erlang -error -errors -event-filter -event-trigger -events -example.com -exec -execute -execution -execution-context -executor -experiments -expiration-date -expire -expires -explicit -explore -expressions -extension -extraction -fail-fast -failures -fallback -fallback-as-issue -fallback-to-issue -false -faster -feature -feature-flag -features -feedback -fetch -file-glob -file-path -filesystem -filter -find_anomalies -find_files -find_referencing_symbols -find_symbol -firewall -flag -flags -fmt -footer -footer-install -footer-text -force-push -force-update -forks -formatted -frontmatter -frontmatter-field -function -functionality -functions -fuzzy -FUZZY:BI-WEEKLY -FUZZY:DAILY -FUZZY:HOURLY -FUZZY:TRI-WEEKLY -FUZZY:WEEKLY -gateway -gateway.apiKey -gatewayVersion -GEMINI_API_KEY -generate -generate-report -generated -generation -get_file_contents -get_me -get_project_structure -get_repository -get_symbols_overview -get_symbol_definition -get_teams -get_team_members -get_user -gh-aw -GH_AW_ACTION_MODE -GH_AW_AGENT_OUTPUT -GH_AW_AGENT_TOKEN -GH_AW_CI_TRIGGER_TOKEN -GH_AW_GITHUB_MCP_SERVER_TOKEN -GH_AW_GITHUB_TOKEN -GH_AW_PROJECT_GITHUB_TOKEN -GH_AW_PROMPT -GH_AW_SAFE_OUTPUTS -GH_AW_SAFE_OUTPUTS_PORT -GH_AW_SAFE_OUTPUTS_STAGED -GH_TOKEN -git-branch -git-commit -git-diff -git-status -github -github-actions -github-app -github-context -github-graphql -github-script -github-token -github.actor -github.base_ref -github.event.issue.number -github.event.pull_request.number -github.job -github.owner -github.ref_name -github.repository -github.run_id -github.run_number -github.server_url -github.workflow -github.workspace -github/gh-aw -githubnext -githubnext/agentics -GITHUB_ACTIONS -GITHUB_ACTOR -GITHUB_PERSONAL_ACCESS_TOKEN -GITHUB_REPOSITORY -GITHUB_TOKEN -GITHUB_WORKFLOW -GITHUB_WORKSPACE -global -glossary -golang -googleapis -GOROOT -grumpy-reviewer -guidance -guides -handlers -hash-check -headers -health -health-check -hide-comment -high-priority -host -host-network -hour -hourly -hourly-schedule -hours -http -http-request -https -ic_kwDOABCD123456 -identifier -identifiers -if-condition -implement -implementation -implements -import-path -imported -imports -incremental -injection-protection -input -input-field -input-validation -inputs -inspect -install -install-gh -installation -instructions -integration -interactive-mode -interface -isolation -issue -issue-ops -issue-triage -issueops -issues -issue_comment -issue_number -iterations -java -javascript -job-output -jobs -jq -json -json-schema -keys -keyword -keyword-search -knowledge -label -label-filter -label-ops -labeled -labeling -labelops -labels -language -language-detection -latest -list_code_scanning_alerts -list_commits -list_discussions -list_issues -list_pull_requests -list_users -list_workflow_runs -list_workflows -layer -libraries -limit -limit-per-run -limits -line -lines -linking -load -local -lock -lock-file -lockdown -lockdown-mode -logic -logs -loops -machine -main -maintainer -management -managing -manual -manual-approval -manually -markdown -match -matching -max-file-count -max-file-size -maximize -mcp -mcp-gateway -mcp-inspect -mcp-list -mcp-registry -mcp-server -mcp-servers -mechanism -mechanisms -member -memory -mention -merge -messages -metadata -metadata-read -migrate -milestone -minimal -mode -module -modules -monday -monitoring -monthly-report -multi-repo -multirepo -multirepoops -my-workflow -myorg -needs.activation -needs.activation.outputs.body -needs.activation.outputs.text -needs.activation.outputs.title -network -network.allowed -network.firewall -nightly-run -node -none -noop -null -on-demand -open-telemetry -OPENAI_API_KEY -operations -operations-log -operator -optional -orchestration -orchestrator -org -organization -organization-projects -organizations -organize -outdated -output-field -output-variable -outputs -override -overrides -owner -owner-name -package -package.json -parallel -parameters -parent -parent_issue_number -parsing -patch -patch-update -path -paths -patterns -payloadDir -perl -permissions -phase -phases -php -pin-versions -pinned -pinning -pip -pipeline -playwright -plugins -plugins.github-token -post-steps -poutine -powershell -pr-comment -pr-event -pr-fix -pr-label -pr-merge -pr-review -pr-title -pre-activation -pre-check -prepend -preview.first_item -preview.item_count -preview.schema -pre_activation -priority -private -private-key -privilege -problem -process -processes -project -project-board -project-column -project-field -project-id -project-item -project-number -project-status -project-title -project-url -project-view -projectops -projects -prompt -prompt-injection -protection -protocol -provider -public -public_repo -pull-request-repo -pull-requests -pull_number -pull_request -pull_requests -pull_request_comment -pull_request_number -pull_request_review_comment -pull_request_target -purpose -push-ref -push-to-branch -push-to-pull-request-branch -py -python -python3 -quality -quality-gate -query -quick-start -ranges -rate -rate-limit -rate-limiting -raw.githubusercontent.com -react -react-emoji -reactions -read -read-all -read-only -read-permission -ready-for-review -recommendations -recompile -reference -references -regenerate -registry -related -relationships -release -remote -remote-server -remove-labels -replace -replace-island -replace_symbol_body -reply-to-pull-request-review-comment -reply_to_pull_request_review_comment -repo -repo-memory -repo-ops -repomix -report-as-issue -report-summary -reporting -report_diagnostics_to_pull_request -repos -repository -repository_features_validation -repository_slug -requirements.txt -research -resolution -resolve-pull-request-review-thread -resolveReviewThread -respond -response -retention-days -retrieve -reusable -reuse -review -reviewer -reviewers -reviews -roadmap-tracking -roles -ruby -run-context -run-failure -run-name -run-started -run-success -runner -running -runs -runs-on -runtime -runtime-env -runtimes -run_id_or_url -rust -safe -safe-inputs -safe-inputs-mode-removal -safe-inputs.mode -safe-mode -safe-output-app -safe-outputs -safe-outputs.app -safe-outputs.env -safe-outputs.footer -safe-outputs.jobs -safe-outputs.messages -safe-outputs.staged -safe-outputs.threat-detection -safe_outputs -sandbox -sandbox-agent-false-removal -sandbox.agent.env -sandbox.agent.mounts -sandbox.mcp.env -sanitized -scale -scenarios -schedule -schedule-cron -scheduled -schedules -schema -schema-consistency-checker -schemas -scope -scout -script -script-step -scripts -search -secret-key -secret-masking -secrets -security -security-events -semantic -semantic-function-refactor -sensitive -separate -services -session -session-analysis -session-insights -setup -severity -share -shared -shared-workflow -shared/common-tools -shared/file -shared/gh -shared/mcp -sharing -shell -shows -sidebar -similar -size -skillz -SLACK_WEBHOOK -skip -skip-bots -skip-if-match -skip-if-no-match -skip-roles -slack -slash -slash_command -small -software -source -source-destination -specfile -specifications -specified -specifies -specify -specVersion -staged -staged-description -staged-title -staging -stale -standard -startupTimeout -start_date -state -states -static -status-update-id -stdio -stop-after -strict -string -structured -sub-issue-closer -sub-issues -submit-pull-request-review -submit_pull_request_review -sub_issue_number -summary -system -tavily -tavily-search -technical-doc-writer -template -template-file -temporary-id -temporary_id -terraform -testing -timeout -timeout-minutes -timeout-minutes-migration -timeout_minutes -timestamp -timezone -timezone-offset -title-prefix -todo -tokens -toolsets -toolTimeout -tracker-id -tracking -tracking-issue -transform -translation -tri-weekly -trial -trials -trigger -trigger-event -triggers -trusted -trusted-domain -ubuntu -ubuntu-22.04 -ubuntu-24.04 -ubuntu-latest -ubuntu-slim -unassign-first -unassign-from-user -unique -unstructured -update-discussion -update-issue -update-project -update-pull-request -update-release -update_issue -update_project -upgrade -upload-asset -upload_asset -users -utc-5 -utc-7 -utc-8 -utc-N -valid -validate -validated -validation -values -variables -variations -vars -verbose -verbose-mode -version -version-bump -version-check -views -visibility -visible-fields -volume -vulnerability-scan -w3c-specification-writer -wasm_exec.js -watch -web-fetch -web-search -webhook -webhook-notify -webhook_notify -weekly -weekly-ops -weekly-research -weekly-summary -worker -workflow -workflow-compile -workflow-compiler -workflow-dispatch -workflow-generator -workflow-health-manager -workflow-run -workflow-status -workflow-trigger -workflows -workflows/ -workflow_call -workflow_dispatch -workflow_file -workflow_file_path -workflow_name -workflow_run -workspace -write-all -write-permission -yaml -YYYY-MM-DD -zizmor -zsh +caught +causal ## Fix Speech-to-Text Errors -When fixing dictated text, correct these common misrecognitions: +### Common Misrecognitions for Project Terms -### GitHub and Git Terms -- "get hub" → github -- "git lab" → gitlab -- "get actions" → github-actions -- "pull request" → pull-request (when used as compound modifier) -- "issue ops" → issueops -- "label ops" → labelops -- "chat ops" → chatops -- "multi repo ops" → multirepoops -- "project ops" → projectops -- "data ops" → data-ops -- "dispatch ops" → dispatch-ops -- "daily ops" → daily-ops +Use these mappings when speech-to-text produces incorrect results: -### Workflow Configuration -- "front matter" → frontmatter -- "safe outputs" → safe-outputs (in configuration context) -- "safe inputs" → safe-inputs (in configuration context) -- "lock file" → .lock.yml or lockfile (depending on context) -- "tool sets" → toolsets -- "M.C.P." or "M C P" → MCP -- "repo memory" → repo-memory (in configuration context) -- "cache memory" → cache-memory (in configuration context) -- "work flow" → workflow -- "timeout minutes" → timeout-minutes -- "runs on" → runs-on +- **"gh-aw"** ← (not "gee-haw", "GA", "G-A-W") +- **"agentic"** ← (not "agent-ic", "agentick") +- **"frontmatter"** ← (not "front-matter" as separate words) +- **"safe-outputs"** ← (not "safe outputs" without hyphen) +- **"safe-inputs"** ← (not "safe inputs" without hyphen) +- **"cache-memory"** ← (not "cash memory", "cache memory") +- **"copilot"** ← (not "co-pilot") +- **"codex"** ← (not "code X", "co-dex") +- **"compile"** ← (not "com-pile", "compile" as two words) +- **"lockfile"** ← (not "lock file", "locked file") +- **"lock.yml"** ← (not "lock YAML", "lock DOT YAML ML") +- **"toolset"** ← (not "tool set", "toolsets") +- **"timeout-minutes"** ← (not "timeout minutes", "time out minutes") +- **"runs-on"** ← (not "runs on" without hyphen in technical context) +- **"workflow-dispatch"** ← (not "workflow dispatch" without hyphen) +- **"github-token"** ← (not "GitHub token" without hyphen, "git hub token") +- **"github-actions"** ← (not "GitHub actions" without hyphen) +- **"github-script"** ← (not "GitHub script" without hyphen) +- **"github-tools"** ← (not "GitHub tools" without hyphen) +- **"issue-ops"** ← (not "issue ops", "issue-opps") +- **"chatops"** ← (not "chat ops", "chat-opps") +- **"MCP servers"** ← (not "empty-see-pee", "MCP serves") +- **"permission"** ← (not "per-mission") +- **"deployment"** ← (not "de-ploy-ment") +- **"concurrent"** ← (not "con-current") -### AI Engines -- "co-pilot" → copilot -- "code x" → codex -- "cloud" → claude (when referring to the AI engine) +### Spacing and Hyphenation Rules -### Commands and Operations -- "G.H. A.W." → gh-aw or `gh aw` (depending on context) -- "re-compile" → recompile -- "work flow dispatch" → workflow_dispatch -- "action lint" → actionlint -- "ziz more" → zizmor -- "poo teen" → poutine +- **Hyphenated command flags**: `--engine`, `--output`, `--json`, `--force` (two hyphens, no spaces) +- **Hyphenated configuration keys**: `cache-memory`, `safe-outputs`, `workflow-dispatch` (use hyphens, not underscores in docs) +- **Underscored environment variables**: `GH_AW_AGENT_TOKEN`, `GH_AW_CROSS_REPO_PAT` (all caps with underscores) +- **File extensions**: `.md` (markdown), `.yml` (YAML), `.cjs` (CommonJS), `.lock.yml` (lockfile) -### File Formats and Extensions -- "dot M.D." → .md -- "dot Y.A.M.L." or "dot Y M L" → .yaml or .yml -- "dot lock dot Y M L" → .lock.yml -- "jason" → JSON (when referring to format) - -### Technical Patterns -- "A.P.I." → API -- "U.R.L." → URL -- "H.T.T.P." → HTTP -- "H.T.T.P.S." → HTTPS -- "S.H.A." → SHA -- "C.I." → CI -- "G.H." → GH (when referring to GitHub CLI) -- "Y.A.M.L." → YAML +## Clean Up and Improve Text -### Hyphenation Rules -Use hyphens for compound modifiers: -- "safe outputs" → safe-outputs -- "safe inputs" → safe-inputs -- "cache memory" → cache-memory -- "timeout minutes" → timeout-minutes -- "cross repository" → cross-repository -- "pull request" → pull-request (when used as adjective) +### Remove Filler Words -### Environment Variables -Capitalize fully: GITHUB_TOKEN, GH_TOKEN, COPILOT_GITHUB_TOKEN, GH_AW_GITHUB_TOKEN, ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY +Delete these words when they don't add meaning: +- **Conversational fillers**: um, uh, humm, hmm, err, erm +- **Unnecessary qualifiers**: you know, basically, like, literally, actually, honestly, really, very, somewhat, kind of, sort of +- **Hedging phrases**: I think, in my opinion, maybe, possibly, arguably +- **Verbal tics**: so, well, anyway, you see, right, okay, got it +- **Repetitive words**: just remove duplicate words in sentences -### Common Ambiguities -- "their/there/they're" → use context to determine correct spelling -- "its/it's" → its (possessive), it's (it is) -- "your/you're" → your (possessive), you're (you are) +### Improve Clarity and Professionalism -## Clean Up and Improve Text +1. **Use active voice**: "The workflow compiles the markdown file" (not "The markdown file gets compiled") +2. **Remove rambling**: Replace "It's like when you have a workflow and it does things and then" with "When a workflow executes" +3. **Fix grammar**: Correct subject-verb agreement, tense consistency, and sentence structure +4. **Replace vague terms**: Instead of "the thing", "the stuff", "it", use specific terms like "the workflow", "the configuration" +5. **Make sentences direct**: "You can use the --engine flag" → "Use the --engine flag" +6. **Remove redundancy**: "The documentation document describes" → "The documentation describes" +7. **Use technical precision**: "The thingy that runs code" → "The GitHub Actions runner" +8. **Remove apologetic language**: "Sorry, but...", "I'm not sure, but..." → Direct statement +9. **Fix common typos**: Configuration → (not "config-uration"), parameters → (not "param-eters") -Remove filler words and improve clarity: +### Guidelines for Transcription Cleanup -### Remove These Filler Words -- humm, um, uh, uhh, umm -- you know, like, basically, actually, literally -- kind of, sort of, I mean, I think -- right?, okay?, so yeah, well +1. **Maintain technical accuracy**: Never change technical terms for "clarity" +2. **Preserve user intent**: Keep the meaning exactly as expressed, just improve presentation +3. **Keep it concise**: Remove filler while maintaining readability +4. **Use consistent terminology**: If the user said "safe-outputs", don't change it to "safe outputs" +5. **Don't plan or provide examples**: Focus only on fixing speech-to-text errors and improving text quality +6. **No code generation**: Never suggest or generate code examples +7. **Don't add guidance**: Only fix what was said, don't advise what should be said -### Improve Clarity -1. Remove redundant phrases: - - "in order to" → "to" - - "at this point in time" → "now" - - "due to the fact that" → "because" - - "in the event that" → "if" +### Example Corrections -2. Make text more concise: - - Remove unnecessary qualifiers (very, really, quite) - - Use active voice instead of passive voice - - Replace wordy phrases with simpler alternatives +Before: +> "So like, you know, basically what happens is you take your workflow and it does this thing where it compiles and uh, kind of validates the markdown file, right?" -3. Maintain technical accuracy: - - Keep all technical terms from the glossary - - Preserve code examples and commands exactly - - Don't simplify technical concepts +After: +> "The workflow compiles and validates the markdown file." -## Guidelines +Before: +> "Actually, I think we need to maybe use the safe-outputs feature, you know, to like create pull requests and stuff like that." -You do not have enough background information to plan or provide code examples. -- do NOT generate code examples -- do NOT plan steps -- focus on fixing speech-to-text errors and improving text quality -- remove filler words (humm, you know, um, uh, like, basically, actually, etc.) -- improve clarity and make text more professional -- maintain the user's intended meaning +After: +> "Use the safe-outputs feature to create pull requests."