feat: Claude Code plugin support and agent-oriented skill docs#127
Merged
feat: Claude Code plugin support and agent-oriented skill docs#127
Conversation
Jira Cloud v3 accepts only ADF for rich content; markdown and wiki markup render as literal text. Agents were defaulting to `workflow comment --text` with markdown syntax and silently getting plain paragraphs. Document the two paths (plain text vs raw ADF), show a realistic multi-node example, and list the common ADF node types so agents can compose rich comments without guessing.
Add .claude-plugin/plugin.json so the repo is installable via /plugin marketplace add and /plugin install without manual file copying. Rename skill/ → skills/ to match the Claude Code plugin convention. Update README and skill-setup.md with plugin install as the primary method.
Split the 3,251-word monolithic SKILL.md into a tight 1,333-word entry point plus four reference files that load on demand. Trims the description to trigger-only phrasing and keeps the reconsile warning, ADF requirement, error-code table, and common mistakes inline. New references/: - adf.md — ADF envelope, node catalog, marks, worked example - operations.md — per-op detail and agent patterns - batch.md — command-name lookup and args conventions - config.md — auth, profiles, operation policy, audit
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Bundles three related agent/plugin changes:
f184d31) — adds.claude-plugin/plugin.jsonso the repo installs via/plugin marketplace add//plugin installwithout manual file copying. Renamesskill/→skills/to match the plugin convention. Updates README and skill-setup docs.3f37df0) — agent guides made explicit that Jira Cloud v3 accepts only ADF for rich content; markdown and wiki markup render literally.da9eb67) — splits the 3,251-word monolithic SKILL.md into a 1,333-word entry point plus four progressive-disclosure reference files (adf.md,operations.md,batch.md,config.md). Tightens the description to trigger-only phrasing.Docs-only from a build/runtime perspective — no code or behavior changes.
Test plan
skills/jira-cli/references/*.mdresolve