Skip to content

[docs] Update dictation skill with ~1000 project-specific terms#28556

Closed
github-actions[bot] wants to merge 2 commits intomainfrom
update-dictation-skill-4d76b6f27a5fdc8f
Closed

[docs] Update dictation skill with ~1000 project-specific terms#28556
github-actions[bot] wants to merge 2 commits intomainfrom
update-dictation-skill-4d76b6f27a5fdc8f

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Updates skills/dictation/SKILL.md with a refreshed Project Glossary of ~1000 terms extracted from the documentation in docs/src/content/docs/**/*.md.

Changes

  • Replaced the existing glossary (~500 terms) with a comprehensive ~1000-term list extracted directly from documentation files
  • Terms cover: frontmatter config fields, engine names, tool names, CLI commands, environment variables, GitHub Actions concepts, MCP servers, safe-outputs operations, and more
  • Alphabetically sorted, one term per line
  • Excluded tooling-specific terms (Astro, Starlight, etc.) and internal implementation details

Term Coverage

The glossary now includes terms from all documentation areas:

  • Configuration: safe-outputs, cache-memory, frontmatter, sandbox, network, permissions
  • Engines: copilot, claude, codex, gemini, crush
  • Commands: compile, audit, mcp, logs, recompile
  • GitHub: workflow_dispatch, pull_request, issues, discussions
  • Tools: bash, edit, github, playwright, web-fetch, web-search
  • Environment variables: GH_AW_*, GITHUB_TOKEN, ANTHROPIC_API_KEY, etc.

Generated by Dictation Prompt Generator · ● 1.7M ·

  • expires on Apr 28, 2026, 6:15 AM UTC

Extracted ~1000 technical terms from docs/src/content/docs/**/*.md
to populate the Project Glossary in skills/dictation/SKILL.md.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@pelikhan
Copy link
Copy Markdown
Collaborator

/q

  • fix all occurrence of copilot to rewritten as @copilot
  • add some python NLP to get statistical histogram of word occurrence precomputed in the steps to be used to refresh the dictation prompt
  • limit to 256 terms

@github-actions
Copy link
Copy Markdown
Contributor Author

github-actions Bot commented Apr 26, 2026

🎩 Mission equipment ready! Q has optimized your workflow. Use wisely, 007! 🔫

@github-actions
Copy link
Copy Markdown
Contributor Author

Issue created: #28566

🎩 Equipped by Q

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 26, 2026

/q

  • fix all occurrence of copilot to rewritten as @copilot...

Done in 2f699a5:

  • @copilot fix: replaced all standalone copilot occurrences in the skill glossary and speech-to-text correction rules with @copilot; the workflow prompt also now consistently says @copilot
  • Python NLP histogram: added a new Step 1 that runs a Python script computing word frequency across all docs/src/content/docs/**/*.md files; generic English words (MUST, SHOULD, true, false, etc.) are excluded inline, and the top 256 project-specific terms are printed directly for use as the glossary
  • 256 terms: trimmed the glossary from ~1000 to exactly 256 terms (frequency-ranked from the histogram)

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • https://api.github.com/graphql
    • Triggering command: /usr/bin/gh /usr/bin/gh api graphql -f query=query($owner: String!, $name: String!) { repository(owner: $owner, name: $name) { hasDiscussionsEnabled } } -f owner=github -f name=gh-aw (http block)
    • Triggering command: /usr/bin/gh /usr/bin/gh api graphql -f query=query($owner: String!, $name: String!) { repository(owner: $owner, name: $name) { hasDiscussionsEnabled } } -f owner=github -f name=gh-aw 7Y47dTp/AiP3WoHP-1 (http block)
    • Triggering command: /usr/bin/gh /usr/bin/gh api graphql -f query=query($owner: String!, $name: String!) { repository(owner: $owner, name: $name) { hasDiscussionsEnabled } } -f owner=github -f name=gh-aw &#34;$k=&#34;.$v[&#34;local-C (http block)
  • https://api.github.com/repos/astral-sh/setup-uv/git/ref/tags/eac588ad8def6316056a12d4907a9d4d84ff7a3b
    • Triggering command: /usr/bin/gh gh api /repos/astral-sh/setup-uv/git/ref/tags/eac588ad8def6316056a12d4907a9d4d84ff7a3b --jq [.object.sha, .object.type] | @tsv (http block)
  • https://api.github.com/repos/github/gh-aw
    • Triggering command: /usr/bin/gh gh api /repos/github/gh-aw --jq .default_branch (http block)

If you need me to access, download, or install something from one of these locations, you can either:


Run the following Python script to compute a statistical histogram of technical term occurrence across all documentation files:

```bash
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot move to steps

@pelikhan pelikhan closed this Apr 26, 2026
Copilot stopped work on behalf of pelikhan due to an error April 26, 2026 11:10
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.

2 participants