Skip to content

Document skills: frontmatter support in reference docs#42675

Closed
Copilot wants to merge 2 commits into
mainfrom
copilot/create-documentation-front-matter-skills-support
Closed

Document skills: frontmatter support in reference docs#42675
Copilot wants to merge 2 commits into
mainfrom
copilot/create-documentation-front-matter-skills-support

Conversation

Copilot AI commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

The frontmatter reference did not describe how to configure skills: entries, which made this capability hard to discover and easy to misuse. This update adds a focused reference section for skills: and links it to deeper schema and packaging docs.

  • Reference coverage

    • Added a new ### Skills (\skills:`)section inreference/frontmatter.md`.
    • Documented supported entry shapes (string and object), SHA pinning requirements, and expression-based refs.
  • Auth semantics

    • Documented per-skill auth fields: skill, github-token, and github-app.
    • Clarified that github-token and github-app are mutually exclusive per entry.
  • Navigation

    • Added direct links to:
      • /gh-aw/reference/frontmatter-full/ for schema-level detail
      • /gh-aw/reference/dependencies/ for package-based distribution context
    • Updated the “Related Documentation” list to include these references.
skills:
  - mattpocock/skills/tdd@801dca688564c529fa84f247f64472520d9ebe28
  - skill: ${{ vars.IMPECCABLE_SKILLS_REF }}
    github-token: ${{ secrets.GITHUB_TOKEN }}

Copilot AI and others added 2 commits July 1, 2026 06:33
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

@pelikhan pelikhan left a comment

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 github actions expression support is removed, do not use those

@pelikhan pelikhan closed this Jul 1, 2026
Copilot AI requested a review from pelikhan July 1, 2026 06:54
Copilot stopped work on behalf of pelikhan due to an error July 1, 2026 06:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants