claude-code - 💡(How to fix) Fix Minor inconsistencies in default system prompt and built-in skills [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#55667Fetched 2026-05-03 04:47:34
View on GitHub
Comments
0
Participants
1
Timeline
4
Reactions
0
Participants
Timeline (top)
labeled ×3cross-referenced ×1
RAW_BUFFERClick to expand / collapse

Three minor consistency/wording defects in Claude Code's default system prompt and built-in skill descriptions. None are critical, but flagging for cleanup.

1. schedule skip-rule diverges between system prompt and skill description

System prompt (Session-specific guidance):

skip it for refactors, bug fixes with tests, docs, renames, routine dep bumps, plain feature merges, or when the user signals closure

Built-in schedule skill description:

Skip the offer for refactors, bug fixes, and anything that is done once it ships.

For "bug fix without tests" the two rules disagree: the system prompt would not skip the offer (only "bug fixes with tests" are in its skip list), but the skill description does skip it. Whichever framing is correct, the two should match.

2. Bash tool description references nonexistent TodoWrite tool

The Bash tool description's commit and PR procedures both contain:

NEVER use the TodoWrite or Agent tools

TodoWrite does not appear in the deferred tool list — it appears to have been renamed to TaskCreate (the system prompt's "Using your tools" section says "Use TaskCreate to plan and track work"). The "no task tracking during atomic git operations" rule presumably still applies to TaskCreate, but the text references a name that no longer exists.

3. "user-invocable skills section" label has no matching heading

The system prompt says:

Only use skills listed in the user-invocable skills section — don't guess.

But the system reminder block that lists skills is headed "skills available for use with the Skill tool", not "user-invocable skills section". Some listed skills are also explicitly not user-invocable (e.g. git-commit, git-worktree — their descriptions say "Do not auto-invoke from the main conversation"), so the label doesn't precisely describe the section it points at.

extent analysis

TL;DR

Update the system prompt and built-in skill descriptions to ensure consistency in skip-rules and terminology.

Guidance

  • Review and align the schedule skip-rules in the system prompt and skill description to ensure they match for "bug fixes with tests" and other conditions.
  • Replace the reference to TodoWrite with TaskCreate in the Bash tool description to reflect the correct tool name.
  • Update the label "user-invocable skills section" to match the actual heading "skills available for use with the Skill tool" or rephrase it to accurately describe the section's content.

Example

No code snippet is provided as the issue is related to text consistency and not code.

Notes

These changes are minor and do not affect the critical functionality but are necessary for maintaining consistency and clarity in the system prompt and skill descriptions.

Recommendation

Apply workaround: Update the system prompt and skill descriptions to ensure consistency, as the issue is related to text defects and not a version-specific problem.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix Minor inconsistencies in default system prompt and built-in skills [1 participants]