Skip to content

[instructions] Sync inline skills instructions with v0.74.8#34905

Open
github-actions[bot] wants to merge 1 commit into
mainfrom
janitor/sync-inline-skills-instructions-c22f783b8337cdfa
Open

[instructions] Sync inline skills instructions with v0.74.8#34905
github-actions[bot] wants to merge 1 commit into
mainfrom
janitor/sync-inline-skills-instructions-c22f783b8337cdfa

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Instructions Update — Synchronized with v0.74.8

Updates .github/aw/ instruction files to reflect the inline skill extraction/runtime support added in #34874 — the only commit between v0.74.8 and now.

Files Changed

  • .github/aw/skills.md — Rewrote the Inline Skills section to document:
    • Block delimiter syntax ## skill: `name`
    • Allowed frontmatter: description only (other fields stripped with warning)
    • Name rules including uniqueness (duplicates = parse error)
    • Engine-specific output paths (claude/codex/gemini flat-file vs. default <name>/SKILL.md)
    • Two-phase extraction: compile-time strips from effective markdown, runtime extractor writes after {{#runtime-import}} resolves
    • Added missing frontmatter --- delimiter to the example workflow snippet
  • .github/aw/github-agentic-workflows.md — Added skills.md row to the Reference Documentation table so the new inline-skill syntax is discoverable from the main entry point.

Commit Reviewed

Size Audit

File Before After Target Status
github-agentic-workflows.md 196 197 <250
skills.md 165 177 (no hard limit)
safe-outputs.md 1074 1074 <1100
syntax.md 964 964 <1000

Safe-Outputs Code vs Instructions Audit

Verified .github/aw/safe-outputs.md against pkg/workflow/compiler_types.go and pkg/workflow/safe_outputs_config.go. All operations exposed by the compiler (create-issue, comment-memory, dispatch-workflow, dispatch_repository, create-code-scanning-alert, actions, scripts, jobs, etc.) are documented. No drift to fix.

Validation

  • Imperative mood, minimal examples
  • Updates routed to the correct sub-file (no detail moved into the main entry file)
  • No content duplication introduced between files
  • File sizes within target limits
  • Verified accuracy against pkg/parser/inline_skill_extractor.go and docs/adr/34874-inline-skill-syntax-mirroring-inline-sub-agents.md

Generated by 🧹 Instructions Janitor · opus47 14.1M ·

  • expires on May 28, 2026, 9:51 AM UTC

Document the inline skill block syntax (## skill: `name`) introduced in
#34874. Clarify supported frontmatter (description only), name
constraints, engine-specific output paths, and the two-phase
compile-strip / runtime-write extraction model.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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 instructions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants