Stephen Way
e7d25ecde7
Some checks are pending
ci / check (push) Waiting to run
Source-of-truth claude/ now matches the proven shape used by
anthropics/claude-plugins-official and other shipping marketplaces:
claude/.claude-plugin/marketplace.json references ./plugins/fj
claude/plugins/fj/.claude-plugin/plugin.json
claude/plugins/fj/skills/fj/SKILL.md
Previous string-source "./" and structured {source: url} forms both
tripped "source type your Claude Code version does not support."
The relative sub-path form works.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
70 lines
2.2 KiB
Markdown
70 lines
2.2 KiB
Markdown
# fj Claude Code plugin
|
|
|
|
A [Claude Code](https://docs.claude.com/en/docs/claude-code) plugin that
|
|
teaches Claude how to use `fj`, the CLI for Forgejo and Gitea-compatible
|
|
instances.
|
|
|
|
The plugin ships a single skill (`fj`) that activates when the user
|
|
mentions fj, Forgejo, Gitea, or any forge-side action (open a PR, list
|
|
issues, cut a release, request a review, etc.) on a non-GitHub host.
|
|
|
|
## Install
|
|
|
|
This directory is both a Claude Code plugin AND a single-plugin
|
|
marketplace. Add the marketplace once, then install:
|
|
|
|
```text
|
|
/plugin marketplace add rasterandstate/fj-claude-plugin
|
|
/plugin install fj@rasterandstate
|
|
```
|
|
|
|
After install, the skill activates automatically when relevant.
|
|
|
|
## Layout
|
|
|
|
```
|
|
claude/
|
|
├── .claude-plugin/
|
|
│ └── marketplace.json marketplace manifest — declares plugins[]
|
|
├── README.md this file
|
|
└── plugins/
|
|
└── fj/
|
|
├── .claude-plugin/
|
|
│ └── plugin.json plugin manifest (name, version, keywords)
|
|
└── skills/
|
|
└── fj/
|
|
└── SKILL.md the skill body — what Claude reads
|
|
```
|
|
|
|
The marketplace lives at the root; each plugin lives in `plugins/<name>/`.
|
|
`marketplace.json` references plugins via `"source": "./plugins/<name>"`.
|
|
This is the working pattern used by `anthropics/claude-plugins-official`
|
|
and other shipping marketplaces.
|
|
|
|
## Updating
|
|
|
|
This `claude/` directory is the source of truth, inside the fj repo at
|
|
[rasterhub.com/rasterstate/fj](https://rasterhub.com/rasterstate/fj).
|
|
|
|
A mirror lives at
|
|
[github.com/rasterandstate/fj-claude-plugin](https://github.com/rasterandstate/fj-claude-plugin),
|
|
synced from this directory. To cut a new version:
|
|
|
|
1. Bump `version` in `.claude-plugin/plugin.json` here.
|
|
2. Update SKILL.md if new fj commands or workflows exist.
|
|
3. Commit + push the fj repo.
|
|
4. Sync the contents of `claude/` over to the mirror repo and tag it:
|
|
|
|
```sh
|
|
# From the fj repo root:
|
|
rsync -av --delete --exclude=.git claude/ /path/to/fj-claude-plugin/
|
|
cd /path/to/fj-claude-plugin
|
|
git commit -am "sync from fj vX.Y.Z"
|
|
git tag vX.Y.Z
|
|
git push origin main vX.Y.Z
|
|
```
|
|
|
|
## License
|
|
|
|
MIT, matching fj.
|