feat: sync documentation with official Claude Code docs by sjnims · Pull Request #192

feat: sync documentation with official Claude Code docs by sjnims · Pull Request #192 · sjnims/plugin-dev

Comprehensive update to align plugin-dev documentation with official
Claude Code documentation. Adds missing features, corrects outdated
information, and introduces new LSP integration skill.

## Skills Updated

- **hook-development**: Add 3 missing events (Setup, PostToolUseFailure,
  SubagentStart), update event count to 12
- **skill-development**: Add context/agent/skills frontmatter, dynamic
  context injection, string substitutions
- **agent-development**: Add skills/permissionMode frontmatter, --agents
  CLI flag documentation
- **mcp-integration**: Add @resource syntax, Tool Search, managed controls
- **plugin-structure**: Add lspServers/outputStyles components, caching docs

## New Content

- **lsp-integration skill**: New skill documenting LSP server configuration,
  extensionToLanguage mappings, pre-built plugins

## Agents/Commands Updated

- **plugin-validator**: Add LSP validation, expand skills list
- **skill-reviewer**: Update optional fields for new frontmatter
- **agent-creator**: Add skills/permissionMode to configuration
- **create-plugin**: Add LSP to component planning and Phase 5

## Version Bump

- 0.2.1 → 0.3.0 (9 skills, was 8)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

self-assigned this

Jan 24, 2026

- Fix list indentation in plugin-validator.md
- Convert bold server names to proper #### headings in popular-lsp-servers.md
- Fix C# heading escape character
- Apply prettier formatting

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

sjnims deleted the feature/docs-sync-with-official branch

January 24, 2026 23:15

sjnims added a commit that referenced this pull request

Jan 24, 2026

## Summary

Version bump to v0.3.0 with changelog updates.

## What's Changed in v0.3.0

### Changed
- Sync documentation with official Claude Code docs (#192)
- Replace deprecated TodoWrite with Task tools (#190)
- Update documentation for Skill tool consolidation (#186)
- Optimize CLAUDE.md with progressive disclosure

### Fixed
- Use dynamic GitHub release badge

### Security
- Remove untrusted checkout in ci-failure-analysis workflow

### CI/CD
- Improve workflow consistency and add YAML linting
- Eliminate workflow dependencies and optimize CI
- Various workflow and template improvements

### Dependencies
- Bump anthropics/claude-code-action to v1.0.34
- Bump actions/checkout to v6.0.2
- Bump actions/cache to v5.0.2
- Bump yamllint to 1.38.0

## Checklist
- [x] Version updated in plugin.json, marketplace.json, CLAUDE.md
- [x] CHANGELOG.md updated with release notes
- [x] Markdownlint passes
- [x] Version consistency verified

🤖 Generated with [Claude Code](https://claude.ai/code)

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

sjnims added a commit that referenced this pull request

Jan 24, 2026

PR #192 introduced dynamic context injection documentation with literal
`!` backtick patterns that trigger shell execution during skill loading.
This replaces them with the [BANG] placeholder established in PR #142.

Fixes regression from feat: sync documentation (#192)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

sjnims added a commit that referenced this pull request

Jan 24, 2026

Updates missed from PR #192:
- Update skill count from 8 to 9 in CONTRIBUTING.md and README.md
- Add LSP Integration to README skills table
- Add 0.3.x to SECURITY.md supported versions

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

sjnims added a commit that referenced this pull request

Jan 24, 2026

Hotfix release addressing:
- [BANG] placeholder regression in skill-development (#192)
- Missing documentation updates for LSP skill

Version bump: 0.3.0 → 0.3.1

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

sjnims added a commit that referenced this pull request

Jan 24, 2026

## Summary

Hotfix release v0.3.1 addressing issues discovered immediately after
v0.3.0:

- **[BANG] placeholder regression** - PR #192 introduced dynamic context
injection documentation with literal `!` backtick patterns, causing
shell execution errors during skill loading
- **Missing documentation updates** - Skill counts and LSP Integration
entries were not updated in CONTRIBUTING.md and README.md

## Changes

### Fixed
- Replace `!` with `[BANG]` in skill-development dynamic context
examples

### Documentation  
- Update skill counts from 8 to 9 in CONTRIBUTING.md and README.md
- Add LSP Integration to README skills table
- Add 0.3.x to SECURITY.md supported versions

### Version Bump
- 0.3.0 → 0.3.1 in plugin.json, marketplace.json, CLAUDE.md
- Updated CHANGELOG.md with release notes

## Checklist

- [x] Version updated in plugin.json, marketplace.json, CLAUDE.md
- [x] CHANGELOG.md updated with release notes
- [x] Markdownlint passes
- [x] Skill loads without shell execution errors

## Test Plan

- [x] Verified `skill-development` skill loads without `!` backtick
errors
- [x] Confirmed all `[BANG]` placeholders are in place via `rg '!\`'
plugins/plugin-dev/skills/`

🤖 Generated with [Claude Code](https://claude.ai/code)

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>