Skip to content

feat: add claude plugin manifests and repo install docs#286

Open
Yongbeom-Kim wants to merge 5 commits intolarksuite:mainfrom
Yongbeom-Kim:feat/claude-plugin-docs-cleanup
Open

feat: add claude plugin manifests and repo install docs#286
Yongbeom-Kim wants to merge 5 commits intolarksuite:mainfrom
Yongbeom-Kim:feat/claude-plugin-docs-cleanup

Conversation

@Yongbeom-Kim
Copy link
Copy Markdown

@Yongbeom-Kim Yongbeom-Kim commented Apr 7, 2026

Summary

  • add root .claude-plugin/plugin.json and .claude-plugin/marketplace.json so the repository exposes a Claude Code plugin bundle
  • update English and Chinese README install docs to clarify CLI vs plugin setup and use claude plugin list for agent verification
  • keep the change set focused on plugin manifests and install documentation

Test plan

  • Review .claude-plugin/plugin.json
  • Review .claude-plugin/marketplace.json
  • Verify install instructions in README.md and README.zh.md

Summary by CodeRabbit

  • New Features

    • Added Claude Code marketplace registration for the Lark CLI plugin (v1.0.4), enabling marketplace discovery and installation.
  • Documentation

    • Added Claude Code install steps to installation and quick-start guides for both human and AI-agent workflows.
    • Clarified standalone installation fallback and updated privacy link/ending newline in README files.

Separate CLI vs Claude plugin setup in the README and replace the invalid agent verification command with claude plugin list.
@github-actions github-actions bot added the size/M Single-domain feat or fix with limited business impact label Apr 7, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 7, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 16fd4bb9-851e-4e11-8651-f75e2ad6b654

📥 Commits

Reviewing files that changed from the base of the PR and between 08b76e4 and 84c32a6.

📒 Files selected for processing (2)
  • README.md
  • README.zh.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.zh.md

📝 Walkthrough

Walkthrough

Added Claude Code marketplace and plugin manifests (.claude-plugin/marketplace.json, .claude-plugin/plugin.json) and updated README docs (README.md, README.zh.md) to include Claude plugin installation commands; no runtime code or API changes.

Changes

Cohort / File(s) Summary
Claude Plugin Manifests
\.claude-plugin/marketplace.json, \.claude-plugin/plugin.json
New marketplace manifest registering larksuite-cli-marketplace and a plugin entry for larksuite/cli; new plugin metadata file (name, version 1.0.4, description, author, homepage, repository, license MIT, keywords).
Installation Documentation
README.md, README.zh.md
Inserted Claude Code install workflow commands (claude plugin marketplace add larksuite/cli and claude plugin install larksuite/cli@larksuite-cli-marketplace) into multiple install sections and ensured trailing newline; documentation-only changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐇 I found a little manifest in the ground,
A marketplace bell with a merry sound.
Docs got some hops, commands in a line,
Claude and Lark now ready to shine.
Off I bounce — plugin time! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: adding Claude plugin manifests and updating installation documentation.
Description check ✅ Passed The description covers the main objectives and includes a test plan, though it uses checkboxes instead of the template's format.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Comment @coderabbitai help to get the list of available commands and usage tips.

@greptile-apps
Copy link
Copy Markdown

greptile-apps bot commented Apr 7, 2026

Greptile Summary

This PR adds .claude-plugin/plugin.json and .claude-plugin/marketplace.json to expose the repository as a Claude Code plugin bundle, and updates both the English and Chinese READMEs to document the claude plugin install path alongside the existing npx skills add path. The manifests are consistent with the install commands shown in the docs, and the previously-raised concern about missing skills discovery has been resolved (auto-discovery is confirmed by the spec). The only remaining nit is a missing trailing newline at the end of both README files.

Confidence Score: 5/5

Safe to merge — all changes are additive documentation and manifest files with no logic impact.

No P0 or P1 findings. The one remaining issue (missing trailing newline) is P2 style-only and does not affect functionality. Prior concerns about skill discovery and install ordering were resolved.

No files require special attention.

Important Files Changed

Filename Overview
.claude-plugin/marketplace.json New marketplace registration; fields consistent with install commands
.claude-plugin/plugin.json New plugin manifest; auto-discovery confirmed for skills
README.md Adds claude plugin install instructions in three places; trailing newline removed at EOF
README.zh.md Chinese README mirrors English changes; trailing newline removed at EOF

Sequence Diagram

sequenceDiagram
    actor User
    participant CC as Claude Code
    participant MP as Marketplace Registry
    participant Repo as larksuite/cli repo
    participant CLI as lark-cli binary

    User->>CC: claude plugin marketplace add larksuite/cli
    CC->>Repo: fetch .claude-plugin/marketplace.json
    Repo-->>CC: marketplace: larksuite-cli-marketplace
    CC->>MP: register marketplace
    MP-->>CC: marketplace registered

    User->>CC: claude plugin install larksuite/cli@larksuite-cli-marketplace
    CC->>MP: resolve larksuite/cli in larksuite-cli-marketplace
    MP->>Repo: fetch .claude-plugin/plugin.json + skills/
    Repo-->>CC: plugin bundle (auto-discovered SKILL.md files)
    CC-->>User: plugin installed

    Note over User,CLI: lark-cli binary must be installed separately\n(npm install -g @larksuite/cli)
Loading

Reviews (3): Last reviewed commit: "docs: clarify AI agent comment" | Re-trigger Greptile

Comment on lines +1 to +15
{
"name": "larksuite/cli",
"version": "1.0.4",
"description": "The official CLI for Lark/Feishu open platform",
"author": "Lark Open Platform",
"homepage": "https://github.com/larksuite/cli",
"repository": "git+https://github.com/larksuite/cli.git",
"license": "MIT",
"keywords": [
"claude-code",
"lark",
"feishu",
"skills"
]
}
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Missing skills reference in plugin manifest

This manifest contains only package metadata but has no skills array or entry field pointing to the 20+ skill files in skills/ (e.g. skills/lark-calendar/SKILL.md, skills/lark-im/SKILL.md). If the Claude Code plugin spec requires an explicit skill list for the system to know what to load, this plugin would install successfully but expose no capabilities. Please confirm whether a skills field (or equivalent) is required, or whether the plugin runtime discovers SKILL.md files by convention from the repository root.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

auto discovery is supported in the Claude plugin spec

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
README.md (1)

66-68: Remove or clarify the installation comments; the commands are technically correct.

The claude plugin marketplace add larksuite/cli command is valid per the Claude Code documentation—it correctly references the GitHub repository source where the marketplace is located. However, the comments "Another option, install Claude Code SKILL" and "If you are Claude Code, you can install it directly" are ambiguous and confusing. These appear to position the commands as alternatives to the required skill installation, when their relationship is unclear. Consider rephrasing for clarity, e.g., specifying whether users should use one method or whether multiple installations are needed.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 66 - 68, The README contains ambiguous comments
around installing the Larksuite CLI with lines "Another option, install Claude
Code SKILL" and "If you are Claude Code, you can install it directly" which
mislead readers about whether these commands are alternatives or required; edit
the README to remove or rephrase these comments so they clearly state the
relationship (e.g., "Alternative: to install via Claude Code, run:" before the
two commands claude plugin marketplace add larksuite/cli and claude plugin
install larksuite/cli@larksuite-cli-marketplace) and ensure the commands and
their purpose (alternative vs required) are explicit and unambiguous.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 115-116: Reword the sentence to remove "directly" and clarify
target users (e.g., "If you are using Claude Code, you can install the plugin
with the following commands:"), replace the current phrasing "If you are Claude
Code, you can install it directly" with that, and then verify the two example
commands (the marketplace add and plugin install commands shown as "claude
plugin marketplace add larksuite/cli" and "claude plugin install
larksuite/cli@larksuite-cli-marketplace") match the actual Claude CLI syntax
used elsewhere in the README (fix any inconsistencies so both command examples
are correct and consistent with the earlier marketplace command usage).

---

Nitpick comments:
In `@README.md`:
- Around line 66-68: The README contains ambiguous comments around installing
the Larksuite CLI with lines "Another option, install Claude Code SKILL" and "If
you are Claude Code, you can install it directly" which mislead readers about
whether these commands are alternatives or required; edit the README to remove
or rephrase these comments so they clearly state the relationship (e.g.,
"Alternative: to install via Claude Code, run:" before the two commands claude
plugin marketplace add larksuite/cli and claude plugin install
larksuite/cli@larksuite-cli-marketplace) and ensure the commands and their
purpose (alternative vs required) are explicit and unambiguous.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: e197ae26-93fb-4c25-a778-ff85b36052dc

📥 Commits

Reviewing files that changed from the base of the PR and between 9739977 and 08b76e4.

📒 Files selected for processing (2)
  • README.md
  • README.zh.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.zh.md

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/M Single-domain feat or fix with limited business impact

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant