Defame1297
8680adf4c0
gitea-releases was the weakest skill in the plugin: no allowed-tools, no owner/repo resolution, and a checkbox list where a dispatch table belongs, so an agent reaching it had to guess both its permissions and its inputs. The id-vs-tag_name trap — deleting by tag name where the API wants the numeric id — is restored as an explicit Gotcha because it destroys the wrong release silently. Elsewhere the `exclusive` flag was documented on the wrong side of the read/write split, and label data from one instance was presented as though it were universal, which invites an agent to assume a taxonomy that does not exist on the target repo. rename_branch was missing from the branch surface. Reference prose and fences are cleaned up in passing.
31 lines
1.6 KiB
Markdown
31 lines
1.6 KiB
Markdown
# gitea-releases
|
|
|
|
Manage Gitea releases and tags — list, create, and delete releases (with draft/prerelease flags and notes) and their underlying tags.
|
|
|
|
## What it does
|
|
|
|
This skill handles release and tag operations for a Gitea repository. It creates releases from a tag/target commitish with title, notes, and draft/prerelease flags; lists and paginates releases and tags; retrieves the latest release; and deletes releases and tags as separate, independent destructive operations. It resolves the numeric release id required for deletion instead of assuming a tag name will work.
|
|
|
|
## Before you start
|
|
|
|
Requires a Gitea MCP server configured with a token holding `write:repository`. Requires a git remote
|
|
named `origin` pointing at the Gitea instance, unless an orchestrating caller already resolved
|
|
`owner`/`repo` for you.
|
|
|
|
## Usage
|
|
|
|
```text
|
|
/gitea-releases
|
|
```
|
|
|
|
Describe your release/tag task: list releases, get the latest release, create a release (with a tag, target, and title), or delete a release or tag. The skill handles resolving the numeric release id where required and keeps release/tag deletion as distinct operations.
|
|
|
|
## Files
|
|
|
|
| File | Purpose |
|
|
|------|---------|
|
|
| `SKILL.md` | Skill instructions for agents |
|
|
| `references/call-signatures.md` | Tool parameters and response shapes derived from gitea-mcp source (see `references/sources.md`); input params for all nine tools additionally cross-checked live against gitea-mcp v1.7.0 |
|
|
| `references/conventions.md` | Semver/draft/prerelease practitioner conventions and pagination behavior |
|
|
| `references/sources.md` | Research sources backing the call signatures and conventions |
|