An open API service indexing awesome lists of open source software.

https://github.com/mackysoft/skills-pack

Reusable Agent Skills for every workspace
https://github.com/mackysoft/skills-pack

agent cli skills

Last synced: 15 days ago
JSON representation

Reusable Agent Skills for every workspace

Awesome Lists containing this project

README

          

# SkillsPack - Agent Skills CLI

[![verify](https://github.com/mackysoft/skills-pack/actions/workflows/verify.yaml/badge.svg)](https://github.com/mackysoft/skills-pack/actions/workflows/verify.yaml) [![NuGet](https://img.shields.io/nuget/v/MackySoft.SkillsPack?label=MackySoft.SkillsPack)](https://www.nuget.org/packages/MackySoft.SkillsPack) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

**Created by Hiroya Aramaki ([Makihiro](https://twitter.com/makihiro_dev))**

SkillsPack is a .NET global tool for distributing reusable Agent Skills to supported agent hosts.

Use it when the same curated skill set should be shared across repositories or user environments without copying `SKILL.md` files by hand.
The package includes canonical skill definitions, generated host-specific skill files, and commands for listing, exporting, installing, updating, diagnosing, and uninstalling skills.

## Install

```bash
dotnet tool install --global MackySoft.SkillsPack
```

Update the tool to receive the latest bundled skills:

```bash
dotnet tool update --global MackySoft.SkillsPack
```

## Quick Start

List available skills and supported hosts:

```bash
skills-pack skills list
```

Install the development skill tier into the current repository:

```bash
skills-pack skills install --host openai --scope project --repo-root . --tier development
```

Install the general writing skill for the current user:

```bash
skills-pack skills install --host openai --scope user --skill writing
```

Preview changes before writing files:

```bash
skills-pack skills install --host openai --scope project --repo-root . --tier development --dry-run --print-diff
```

Check installed project skills:

```bash
skills-pack skills doctor --host openai --scope project --repo-root . --tier development
```

## Included Skills

SkillsPack includes these reusable skills:

| Skill | Tier | Purpose |
| --- | --- | --- |
| `branch-create` | `development` | Create or reuse task branches with repository naming rules. |
| `changelog` | `development` | Write reader-facing changelogs, release notes, and PR change summaries. |
| `code-quality-review` | `development` | Review code for duplication, low cohesion, excess state, and unnecessary abstraction. |
| `commit` | `development` | Create responsibility-scoped Conventional Commit messages. |
| `csharp-authoring-rules` | `development` | Apply C# implementation and review judgment rules. |
| `issue-planner` | `development` | Split tasks and specifications into single or parent-child GitHub Issue structures. |
| `issue-writer` | `development` | Write, create, update, or review structured GitHub Issue bodies. |
| `pr-submit` | `development` | Verify, push, and create or update pull requests. |
| `pr-merge` | `development` | Merge pull requests through CI and branch cleanup. |
| `push` | `development` | Commit pending work when needed and push the current branch safely. |
| `review-triage` | `development` | Triage review comments against code, specifications, and evidence. |
| `sync-latest` | `development` | Fetch origin and safely synchronize the current branch with the right base. |
| `test-writer` | `development` | Design and create contract-based tests. |
| `ultra-review` | `development` | Run deeper multi-pass review and apply safe fixes. |
| `unity-authoring-rules` | `development` | Apply Unity-specific implementation and review judgment rules with C# rules. |
| `verification-gate` | `development` | Run the verification needed before PRs or final checks. |
| `writing` | `general` | Write, revise, review, summarize, and localize natural-language text while preserving meaning and structure. |
| `xml-doc-writer` | `development` | Write contract-focused XML documentation comments. |

## Tiers

SkillsPack defines these tiers:

| Tier | Purpose |
| --- | --- |
| `general` | General-purpose reusable skills. |
| `development` | Code, review, test, Git, and pull request workflow skills. |
| `personal` | Skills for my personal environment and workflow setup. |

Empty tiers are valid.
They are still reported by `skills-pack skills list` so automation can discover the full supported tier set.

## Skill Selection

`--tier` selects one or more skill tiers.
`--skill` selects exact `skillName` values.
Selectors accept comma-separated values:

```bash
skills-pack skills install --host openai --scope project --repo-root . --tier general,development
skills-pack skills install --host openai --scope project --repo-root . --skill changelog,commit
```

`skills list` can run without selectors.
For `export`, `install`, `update`, `doctor`, and `uninstall`, at least one package selector is required: `--tier` or `--skill`.

When both `--tier` and `--skill` are specified, selected skills must match the selected tiers.
Exact skill selections also include transitive dependencies declared by the selected skills.
For example, selecting `pr-merge` also exports or installs the Git and PR workflow skills it invokes.

## Command Reference

List bundled skills, supported hosts, tiers, and package counts:

```bash
skills-pack skills list
skills-pack skills list --tier development
skills-pack skills list --tier general,development
skills-pack skills list --skill changelog
skills-pack skills list --tier development --skill changelog
```

Export host-specific skill files:

```bash
skills-pack skills export --host openai --tier development --output ./exported-skills
skills-pack skills export --host openai --skill changelog --output ./exported-skills
```

Install skills into a repository:

```bash
skills-pack skills install --host openai --scope project --repo-root . --tier development
skills-pack skills install --host openai --scope project --repo-root . --skill changelog
```

Update installed skills:

```bash
skills-pack skills update --host openai --scope project --repo-root . --tier development
```

Diagnose installed skills:

```bash
skills-pack skills doctor --host openai --scope project --repo-root . --tier development
```

Uninstall managed skills:

```bash
skills-pack skills uninstall --host openai --scope project --repo-root . --tier development
```

Install skills into the current user's host skill directory:

```bash
skills-pack skills install --host openai --scope user --tier development
skills-pack skills install --host openai --scope user --skill writing
```

Use `--dry-run` before changing installed files:

```bash
skills-pack skills install --host openai --scope project --repo-root . --tier development --dry-run --print-diff
skills-pack skills doctor --host openai --scope project --repo-root . --tier development
```

Supported hosts are reported by `skills-pack skills list`.

## Author

Hiroya Aramaki is an indie game developer in Japan.

- Website:
- GitHub:

## License

SkillsPack is under the [MIT License](LICENSE).