Files
claude-code-skills-reference/claude-skills-troubleshooting/references/known_issues.md
daymade 35872b9e77 Release v1.24.0: Add claude-skills-troubleshooting
- Add claude-skills-troubleshooting v1.0.0
  - Plugin installation and enablement debugging
  - Diagnostic scripts for installed vs enabled mismatch
  - Known GitHub issues tracking (#17832, #19696, #17089, #13543, #16260)
  - Skills vs Commands architecture documentation
  - Batch enable script for missing plugins

- Add i18n-expert v1.0.0
  - Complete i18n/l10n setup for React/Next.js/Vue
  - Key architecture and locale file organization
  - Translation generation strategy (AI, professional, manual)
  - Key parity validation between en-US and zh-CN
  - Bundled i18n_audit.py script

- Update marketplace to v1.24.0 (32 skills)
- Update README.md badges (skills count, version)
- Update README.zh-CN.md badges (skills count, version)
- Update CLAUDE.md skills count and Available Skills list
- Update youtube-downloader with PO token enhancements

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-22 22:05:14 +08:00

2.2 KiB

Known Claude Code Plugin Issues

This document tracks known bugs and issues related to Claude Code plugins.

Open Issues

GitHub #17832 - Plugins Not Auto-Enabled After Install

Status: OPEN URL: https://github.com/anthropics/claude-code/issues/17832

Problem: When installing a plugin from a marketplace, Claude Code adds the plugin to installed_plugins.json but does NOT add it to settings.json enabledPlugins.

Impact: Plugins appear "installed" but don't function. Skills silently fail to load.

Workaround: Manually enable via CLI or edit settings.json:

claude plugin enable plugin-name@marketplace

GitHub #19696 - installed_plugins.json Naming Misleading

Status: OPEN URL: https://github.com/anthropics/claude-code/issues/19696

Problem: The file installed_plugins.json contains ALL plugins ever registered, including disabled ones. The actual enabled state is tracked separately in settings.json.

Impact: Confusing for developers - file shows many plugins but only some are active.

Note: This is a naming/documentation issue, not a functional bug.


GitHub #17089 - Local Plugins Breaking After 2.1.x Update

Status: Reported URL: https://github.com/anthropics/claude-code/issues/17089

Problem: Local plugins no longer persist after the 2.1.x update.

Workaround: Create a marketplace wrapper structure for local plugins.


GitHub #13543 - MCP Servers from Marketplace Not Available

Status: Reported URL: https://github.com/anthropics/claude-code/issues/13543

Problem: After updating to Claude Code 2.0.64, MCP servers defined in marketplace plugins were no longer available.


GitHub #16260 - Contradictory Scope Error Messages

Status: Reported URL: https://github.com/anthropics/claude-code/issues/16260

Problem: CLI gives contradictory error messages about plugin scope.

Workaround: Manually edit settings.json to fix scope issues.

Resolved Issues

(Add resolved issues here as they are fixed)