Consider a unified Lark CLI skill organization similar to an umbrella skill
Nobody has claimed this yet.
- Dominant language
- Go
- Stars
- 17.3k
- Forks
- 1.4k
- Avg merge
- 2d 4h
- Merged PRs (30d)
- 105
Description
Motivation
Lark CLI currently exposes many domain-specific AI Agent Skills (IM, Docs, Drive, Calendar, Sheets, Base, Mail, Tasks, Approval, etc.). This is powerful, but it also makes the injected skill list very large in agent environments.
In practice, this can create a few problems:
- Higher baseline token usage before the user even starts the task.
- More cognitive overhead for the agent when selecting among many similar
lark-*skills. - More fragmented discoverability: users need to know whether to ask for
lark-doc,lark-drive,lark-sheets,lark-base,lark-calendar, etc. - Harder long-term maintenance when adding new Lark product domains, because each domain becomes another top-level skill entry.
Proposal
Consider adding, or optionally switching to, a more unified skill organization model similar to an umbrella skill:
- Provide one top-level
lark-cli/larkskill as the primary entry point. - Inside that skill, route to subdomains such as:
imcontactdocdrivewikicalendarvcminutessheetsbasemailtaskapprovalattendanceopenapi
- Keep domain-specific instructions in referenced files or lazily loaded sections, instead of injecting every domain skill description into the initial agent context.
- Optionally keep the existing
lark-*skills for backward compatibility, but recommend the unified entry point for users who care about context size and simpler agent routing.
Expected benefits
- Lower default prompt/token overhead in agent environments.
- Simpler skill discovery: users can think in terms of "use Lark CLI" instead of choosing from many top-level Lark skills.
- More predictable routing for agents: one Lark entry point can perform intent classification and then load the appropriate domain workflow.
- Easier extensibility as more Lark product capabilities are added.
Compatibility suggestion
This could be introduced non-disruptively:
- Add a new unified
lark-cliskill. - Keep existing
lark-*skills unchanged for advanced/direct use. - Document that agent users may install/use the unified skill when they want a smaller top-level skill surface.
- Gradually move shared guidance (auth, identity switching, permission handling, common CLI conventions) into shared references used by both the unified skill and domain skills.
Thanks for building and open-sourcing Lark CLI. The current domain-specific skills are already very useful; this proposal is mainly about improving token efficiency and agent ergonomics as the skill surface grows.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing the existing domain-specific AI Agent Skills and the shared guidance around auth, identity switching, permissions, and common CLI conventions. Compare their current top-level organization with the proposed unified lark-cli/lark entry point; done means a decided organization, documented compatibility behavior, and an agreed approach for lazy or referenced domain guidance.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- go
- Domain
- cli, developer-experience, tooling
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100