tomevault-io package-authoring
Use this skill before adding or changing anything intended for publication in AI Workflow Kits.
Core Rule
Organize by workflow first, runtime second, artifact type third.
packages/<package-id>/
├─ README.md
├─ manifest.yaml
├─ codex/
├─ claude/
├─ gemini/
├─ copilot/
├─ plugins/
└─ examples/
Do not create top-level skills/, agents/, or plugins/ folders for one artifact type.
Placement
| Artifact | Location |
|---|---|
| Codex skill | packages/<package-id>/codex/skills/<skill-id>/SKILL.md |
| Codex instructions | packages/<package-id>/codex/AGENTS.md |
| Claude Code agent | packages/<package-id>/claude/agents/*.agent.md |
| Claude Code hook | packages/<package-id>/claude/hooks/ |
| Claude command | packages/<package-id>/claude/commands/ |
| Gemini prompt | packages/<package-id>/gemini/prompts/ |
| Gemini instructions | packages/<package-id>/gemini/GEMINI.md |
| Copilot instructions | packages/<package-id>/copilot/github/copilot-instructions.md |
| Copilot prompt | packages/<package-id>/copilot/github/prompts/ |
| Optional plugin | packages/<package-id>/plugins/<plugin-id>/ |
| Example workflow | packages/<package-id>/examples/<example-id>/ |
Workflow
- Identify the workflow package.
- If it is new, create it from
templates/package-template/. - Add runtime-native files under the matching runtime folder.
- Update package
manifest.yaml. - Update root
REGISTRY.md. - Update root
registry.yaml. - Add or update a public-safe example.
- Run
python tools/public-safety-scan.py --history. - Commit only after the scan passes.
Public Safety
Before publishing, verify that the package does not expose private workspace details, internal project labels, local paths, generated logs, local audit trails, large generated artifacts, or credential-like values.
Use docs/publication-guard.md as the detailed rule source.
Output
When reporting completion, include:
- package path
- runtime folders changed
- registry files updated
- examples added or updated
- public safety scan result
Source: shinjaehyun20/ai-workflow-kits — distributed by TomeVault.