[text-auditor] Fix wording inconsistencies in workflow prompts and script help text #529

Text Improvements

The following user-facing text issues were found in the repository. Each is a low-effort fix.

1. Incorrect verb form (Layout vs Lay out) in issue-triage prompt

File: claude-workflows/issue-triage/ro/action.yml (line 131)
Current text: 2. Layout a single high-quality and actionable recommendation for how to address the issue based on your knowledge of the project, codebase, and issue
Suggested fix: 2. Lay out a single high-quality and actionable recommendation for how to address the issue based on your knowledge of the project, codebase, and issue
Why: Grammar error in user-facing instruction text.

2. Same verb-form error in rwx variant

File: claude-workflows/issue-triage/rwx/action.yml (line 148)
Current text: 2. Layout a single high-quality and actionable recommendation for how to address the issue based on your knowledge of the project, codebase, and issue
Suggested fix: 2. Lay out a single high-quality and actionable recommendation for how to address the issue based on your knowledge of the project, codebase, and issue
Why: Same grammar error as the read-only variant.

3. Script usage text omits supported any conclusion value

File: scripts/fetch-workflow-logs.py (line 13)
Current text: --conclusion STATUS Filter by conclusion: success, failure, cancelled, skipped (default: failure)
Suggested fix: --conclusion STATUS Filter by conclusion: success, failure, cancelled, skipped, any (default: failure)
Why: The script accepts any (conclusion_filter = None if args.conclusion == "any" else ... at line 131), so the help/usage text is misleading.

4. Contradictory command guidance in issue-triage read-only prompt

File: claude-workflows/issue-triage/ro/action.yml (lines 100 and 121-123)
Current text: You CANNOT: ... execute commands ... and later Read-only git commands: git status, git diff, git log, git show, git tag
Suggested fix: Clarify the prohibition to exclude explicitly allowed read-only git commands (or remove the contradictory phrase).
Why: Current wording gives conflicting instructions to users/agents.

5. Contradictory command guidance in PR review read-only prompt

File: claude-workflows/pr-review/ro/action.yml (lines 139 and 171-173)
Current text: You CANNOT: ... execute commands ... and later steps instruct running helper scripts (pr-prior-reviews.sh, pr-existing-comments.sh, pr-diff.sh).
Suggested fix: Clarify that only explicitly listed review helper commands are allowed.
Why: Current wording conflicts with later required workflow steps.

Suggested Actions

• Replace Layout with Lay out in both claude-workflows/issue-triage/ro/action.yml and claude-workflows/issue-triage/rwx/action.yml.
• Update scripts/fetch-workflow-logs.py usage text to include the any value for --conclusion.
• Resolve contradictory command-permission wording in claude-workflows/issue-triage/ro/action.yml.
• Resolve contradictory command-permission wording in claude-workflows/pr-review/ro/action.yml.

What is this? | From workflow: Text Auditor

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.

• expires on Mar 9, 2026, 1:37 PM UTC