Bundled visualize skill unconditionally conflicts with host progress and compaction contracts
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Newbie friendliness
- 85/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Domain
- documentation
Research direction
Start with skills/visualize/SKILL.md and compare its communication and Context compaction sections with the proposed text-only diff in the issue. Verify that host communication requirements take precedence, applicable instructions are preserved across compaction, and unrelated visualization contracts remain unchanged.
Written by the indexing model from the issue text.
Description
Component
Bundled visualize plugin 1.0.29, skills/visualize/SKILL.md.
Actual
The skill unconditionally requires silent work and makes the final response the first user-facing message; it also forbids announcing the skill. On a host that requires skill announcements and progress updates, these lower-priority instructions conflict with the host contract. Its compaction instructions additionally force rereading the entire skill after every compaction even when the applicable contract was retained.
Expected
Defer communication to the host requirements, keeping updates concise. Preserve applicable instructions across compaction and reread when missing or changed. This is a proposed instruction-compatibility improvement for such hosts, not a claim that all hosts have identical communication requirements or that token savings have been measured.
Candidate and boundary
The text-only candidate below was reviewed against the installed version. The installed cache was later observed at its original bytes; the responsible writer was not identified. No updater-specific cause or released fix is claimed.
--- a/skills/visualize/SKILL.md
+++ b/skills/visualize/SKILL.md
@@ -19,18 +19,15 @@
- Use Mermaid when labeled nodes and edges fully explain a static structure;
return a normal fenced Mermaid block and no visualization file. Use HTML for
dynamics, spatial motion, adjustable inputs, and other visuals.
-- Work silently unless blocked or the user explicitly asks for progress. Never
- send commentary or progress updates while reading this skill or writing or
- updating the file; the final response must be your first user-facing message.
+- Follow the current host's communication requirements and keep progress updates concise.
- In user-facing prose, describe only what the visual helps the user see or
decide. Keep it concise and do not repeat information already clear from the
- visual. Never announce this skill, a visualization surface, widgets, HTML,
+ visual. Follow the host's Skill announcement rule; otherwise omit widgets, HTML,
SVG, scripts, local files, inline data, or implementation details.
## Context compaction
-Copy into every compaction summary:
-`Reload the full visualize skill before creating or updating a visualization.`
+Preserve applicable instructions in the compaction summary. Reread only when the needed contract was not retained or has changed.
## Inline HTML output contract
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.5k
- Avg merge
- 1m
- Merged PRs (30d)
- 1k
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from openai/codex
-
enhancement remote
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
bug CLI windows-os
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
macOS sandbox blocks hw.optional.arm64 sysctl, causing Flutter to misdetect Apple Silicon as x64 Openbug CLI sandbox
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
bug CLI TUI
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
-
CLI config enhancement skills
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Similar issues
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
gitbutlerapp/gitbutler#15998 · 1 comment ·
-
bug triage:deciding
Difficulty 1/5 Under an hour Newbie friendliness 88/100
open-telemetry/otel-arrow#4132 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
bitcoindevkit/bdk-ffi#1125 ·