agent-skills-distribution-template
A vendor-neutral starting point for a portable agent skills distribution.
Open source Open in the app JSON README (API)
About
A vendor-neutral starting point for a portable agent skills distribution.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- tacticaldoll
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.1.0
- Last push
- 2026-07-18T17:03:36Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
tacticaldoll/agent-skills-distribution-template
README
# Agent Skills Distribution Template A vendor-neutral, valid empty repository for publishing portable agent skills. Use it as a GitHub template or clone it, run the initializer, and add skills under `skills/`. ## Start a distribution ```sh python3 scripts/init_distribution.py \ --name my-skills \ --display-name "My Skills" \ --description "Portable skills for my domain." \ --repository https://github.com/example/my-skills ``` The initializer updates the canonical `distribution.json` and every checked-in host manifest. It supports `--dry-run` and refuses to overwrite an already initialized distribution unless `--force` is supplied. Create a skill from `templates/skill`, then validate the repository: ```sh cp -R templates/skill skills/my-workflow python3 scripts/validate_distribution.py ``` ## Contract - `distribution.json` is the source of truth for distribution identity, release version, repository, and skills directory. - Root host manifests are packaging projections and must match the canonical identity and version. - Each production skill lives at `skills/<lowercase-hyphen-name>/` with `SKILL.md` and `skill.yaml`. - Host-specific metadata stays at the repository packaging layer, not inside individual skills. See [the distribution schema](docs/distribution-json-schema.md) for the complete contract. ## Deployment engine compatibility CI validates the repository locally and asks the released engine to load its distribution contract without requiring any agent host to be installed. It uses [`agent-skill-deployer`](https://github.com/tacticaldoll/agent-skill-deployer). The deployment engine keeps its required unit tests network-free by using a neutral local fixture with this same contract. ## License MIT — see [LICENSE](LICENSE).