docs(features): explain the Claude Code integration from a user view - #710
Conversation
The "Editors and agents" feature page named only two of the five Claude Code plugins and gave no path to install or use them. Rework the page so the agent story gets concrete, user-facing coverage: - Lead with the shared-engine payoff for editor and agent together. - Describe what each plugin does for the user: mdsmith-lsp, mdsmith-autofix, the three slash commands, the markdown-reviewer subagent, and the markdown-audit skill. - Add the one marketplace-register line and link to the install guide's Claude Code section for per-plugin setup. - Note mdsmith makes no network call of its own, linking telemetry. Refresh the summary, which cascades into the CLAUDE.md catalog and the AGENTS.md / copilot-instructions includes. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01K1ba2VNTt2KcoVSwmRMBvz
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files
☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
|
🟢 Merge Queue — picked up This PR is in the queue and will be batched with other Next: No action needed — you'll get another comment when CI starts on the batch. View merge queue run. |
|
🔵 Merge Queue — CI running Merged into batch branch Next: No action needed — you'll be notified when CI completes. |
|
✅ Merge Queue — merged This PR landed on Next: Done — nothing more to do here. |
Why
The "Editors and agents" feature page
(
docs/features/editor-agent-integration.md) was written almostentirely around the VS Code extension. It named only two of the five
user-facing Claude Code plugins (
mdsmith-lspand the audit skill) andgave a reader no way to learn what the integration does or how to turn
it on. A user who wants mdsmith in Claude Code left the page no better
informed.
What changed
Reworked the page so the agent story gets concrete, user-facing
coverage, balanced with the editor story:
merge is the same one the editor shows you and the same one the agent
sees as it edits — no second config or ruleset.
mdsmith-lsp(inline diagnostics + navigation),
mdsmith-autofix(post-editmdsmith fixhook), the three slash commands (/mdsmith-fix,/mdsmith-check,/mdsmith-kinds), themarkdown-reviewersubagent,and the
/markdown-auditskill./plugin marketplace add jeduden/mdsmithline, then a link to the install guide's existing
Claude Code plugins section
for per-plugin commands and prerequisites.
linking the telemetry policy.
<?include?>block and theprogressive-disclosure pairing.
Refreshed
summaryto reflect the broader integration. That cascadesthrough the
CLAUDE.mdcatalog and theAGENTS.md/copilot-instructions.mdincludes, which were regenerated withmdsmith fix.No new doc file was needed — the per-plugin setup steps already live in
the install guide; this page now points there.
Verification
mdsmith check .passes (519 files, 0 failures).sentences, no banned vocabulary or openers, no em-dashes in the new
prose, no bold-label-colon list rhythm.
🤖 Generated with Claude Code
https://claude.ai/code/session_01K1ba2VNTt2KcoVSwmRMBvz
Generated by Claude Code