[docs] Update documentation for logs command and skip-bots/skip-roles features

[github-actions]

Documentation Updates - February 16, 2026

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

1. Flexible workflow name matching for logs command (from Add flexible workflow name matching to logs command #16007)

   • Documents that logs command now accepts both workflow IDs (kebab-case) and display names
   • Adds examples showing case-insensitive matching for both formats
   • Improves UX consistency with compile and status commands

2. Skip-roles field (from Add skip-roles to conditionally skip workflows based on repository permissions #15988)

   • Documents on.skip-roles for conditionally skipping workflows based on repository permissions
   • Explains pre-activation checking, union merging behavior, and use cases
   • Adds examples for AI moderation workflows

3. Skip-bots field (from Add on.skip-bots field to cancel workflows for specific GitHub actors #15993)

   • Documents on.skip-bots for skipping workflows based on GitHub actor identity
   • Explains automatic bot name matching with/without [bot] suffix
   • Adds examples for preventing bot-to-bot interactions

Changes Made

• Updated docs/src/content/docs/setup/cli.md:

  • Added "Workflow name matching" section under logs command
  • Documented case-insensitive matching for both workflow IDs and display names
  • Added examples showing various input formats

• Updated docs/src/content/docs/reference/frontmatter.md:

  • Added skip-roles and skip-bots to the on: section feature list
  • Added comprehensive "Skip Roles" section with syntax, behavior, and examples
  • Added comprehensive "Skip Bots" section with syntax, bot name matching, and examples
  • Positioned documentation logically after existing bot filtering section

Merged PRs Referenced

• Add flexible workflow name matching to logs command #16007 - Add flexible workflow name matching to logs command
• Add skip-roles to conditionally skip workflows based on repository permissions #15988 - Add skip-roles to conditionally skip workflows based on repository permissions
• Add on.skip-bots field to cancel workflows for specific GitHub actors #15993 - Add on.skip-bots field to cancel workflows for specific GitHub actors

Notes

Other merged PRs from the last 24 hours were primarily internal refactoring, dependency updates, or breaking changes to deprecated features that are already documented. The three features documented here are the main user-facing additions that needed documentation updates.

Additional PRs reviewed but not requiring documentation updates:

• Update ai-moderator workflow to use codex engine #16010 - Update ai-moderator workflow to use codex engine (internal workflow change)
• Remove srt and sandbox-runtime from schema, retain migration codemod #15999 - Remove srt and sandbox-runtime from schema (already documented in [docs] Update sandbox documentation to reflect SRT removal #15865)
• Refactor locked issue error handling into shared helper #15998 - Refactor locked issue error handling (internal refactoring)
• Specify MCP server constraint enforcement for immediate LLM feedback #15996 - MCP server constraint enforcement (specification update, not user-facing)
• Resolve nested imports and symlinks #15987 - Resolve nested imports and symlinks (internal import handling improvement)

AI generated by Daily Documentation Updater

• expires on Feb 17, 2026, 1:02 AM UTC