Skip to content

Commit 0ed9a0d

Browse files
authored
Introduce a skeleton directory for hosting Claude plugins (#6656)
Motivation: Recently, there was an agreement to host claude plugins with useful features (skills/agents) that may aid in development using Armeria. This PR introduces a basic skeleton directory, and a page on the armeria site explaining the motivation. Considerations: - Plugins will be hosted in a separate directory within the repository - independent from the site - While it may be nice for documentation references to be embedded in the skill, testing shows that Claude can read the documentation hosted (although I assume each session will have to fetch newly if not in the context already). This may be improved on later if necessary - As installing the plugin is not very difficult, I don't think the additional complexity of hosting the files separately on the website is worth it. If there are any users interested, we may support later. - A single common plugin is published for now - While we may later consider publishing a plugin per-module, I think it's simplest to start with a single plugin. - All skills/agents aren't loaded in the context immediately from what I understand - If context consumption is a problem, maybe `disable-model-invocation` can help Modifications: - Added a `marketplace.json` which contains the version/plugin information - Added a `Claude` related page under `Community` which describes how the plugin may be used - Created a skeleton directory for skills Result: - Closes #6639 <!-- Visit this URL to learn more about how to write a pull request description: https://armeria.dev/community/developer-guide#how-to-write-pull-request-description --> ref: <img width="760" height="542" alt="스크린샷 2026-03-06 오전 11 22 50" src="https://github.com/user-attachments/assets/7aa31b58-2f6c-4dcb-b65d-5e8baac8d620" />
1 parent 1c00618 commit 0ed9a0d

5 files changed

Lines changed: 53 additions & 0 deletions

File tree

.claude-plugin/marketplace.json

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
{
2+
"name": "armeria",
3+
"owner": {
4+
"name": "armerian",
5+
"email": "dl_armeria@linecorp.com"
6+
},
7+
"metadata": {
8+
"description": "Claude plugin for the Armeria microservice framework",
9+
"version": "0.0.1"
10+
},
11+
"plugins": [
12+
{
13+
"name": "assistant",
14+
"source": {
15+
"source": "git-subdir",
16+
"url": "https://github.com/line/armeria.git",
17+
"path": "tools/claude-plugins/assistant"
18+
}
19+
}
20+
]
21+
}

site-new/sidebarsCommunity.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ const sidebars: SidebarsConfig = {
77
'developer-guide',
88
'code-of-conduct',
99
'design-resources',
10+
'claude-plugin',
1011
],
1112
};
1213

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Claude Plugin
2+
3+
We maintain a [Claude](https://claude.ai/) plugin that may be useful for the community to use AI-powered guidance for development.
4+
5+
## Installation
6+
7+
You can install the Armeria Claude plugin from the marketplace:
8+
9+
```bash
10+
/plugin marketplace add line/armeria
11+
/plugin install assistant@armeria
12+
```
13+
14+
## Contributing
15+
16+
To contribute new features to the Claude plugin:
17+
18+
1. Create or update a markdown file in `<project dir>/tools/claude-plugins/assistant`
19+
2. Reference official Armeria documentation URLs if applicable
20+
3. Submit a pull request for review
21+
22+
## References
23+
24+
- [Claude Plugin Marketplaces Documentation](https://code.claude.com/docs/en/plugin-marketplaces)

site-new/src/content/community/index.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,10 @@ Check out [the developer guide](/community/developer-guide) to learn how to buil
3838

3939
We expect contributors to follow [our code of conduct](/community/code-of-conduct).
4040

41+
## Using AI assistants? 🤖
42+
43+
We provide a [Claude plugin](/community/claude-plugin) to help you work with Armeria more effectively using AI-powered assistance.
44+
4145
## Hall of fame 🏛️
4246

4347
<ThankYou
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
{
2+
"name": "assistant"
3+
}

0 commit comments

Comments
 (0)