workbay-system
Component of the
workbaystack. You usually installworkbay, not this package directly.
Shared workbay-system surface: skills, hooks, contracts, commands, prompts, and the validators that keep them coherent.
This repository is MVP-scope-private internal tooling. It is consumed by
the workbay-bootstrap CLI, which clones it into
<consumer-root>/.workbay/remote/ and symlinks selected surfaces into
consumer repos. There is no LICENSE or CONTRIBUTING file by design.
Contents
The canonical sources are model-agnostic. Per-agent surfaces
(.claude/skills/, .claude/commands/, .github/prompts/,
.codex/skills/, .cursor/skills/, .grok/plugins/workbay-system/, ...) are
generated into target repos by
scripts/generate_agent_workflows.py during workbay-bootstrap install.
They do not exist in this package's source tree.
| Path | Purpose |
|---|---|
skills/<slug>/skill.yaml |
Canonical structured metadata per skill. Validates against workbay_protocol.SkillManifest. |
skills/<slug>/body.md |
Canonical prose body per skill. Plain Markdown, no frontmatter. |
config/agent-workflows/portable_commands.json |
Source-of-truth manifest for the portable command router. |
scripts/generate_agent_workflows.py |
Renders the manifest + skills into per-agent artifacts (Claude commands + skill packs, Copilot prompts, Codex router blocks, Codex/Cursor/grok skill copies). |
scripts/check_skills.py |
Skill-anatomy validator (delegates structured validation to workbay_protocol.SkillManifest). |
scripts/check_harness_sync.py |
Cross-harness contract validator. |
scripts/migrate_skills_to_neutral_layout.py |
One-shot migration helper from the legacy .claude/skills/<slug>/SKILL.md layout. |
scripts/hooks/ |
Claude Code / Copilot shared hooks plus client-side git hooks. |
docs/workbay/contracts/ |
YAML contracts (harness-protocol.yaml and friends). |
docs/workbay/maps/mcp-tool-routing.yaml |
Routing map consumed by check_skills.py to validate mcp_tools references. |
docs/plugin-distribution.md |
Operator guide for make plugins-build / make plugins-check and the Claude / Codex / Cursor / grok install flow. See also ADR-001. |
Makefile.d/plugins.mk |
Make-target fragment wiring plugins-build / plugins-check to generate_agent_workflows.py --mode=plugin. |
Versioning
This repository uses Semantic Versioning. The current package release is
workbay-system 0.4.0; the current monorepo distribution tag is
v0.1.24. See CHANGELOG.md for the full history.
Provenance
v0.2.0was extracted from a consumer repository snapshot. It expands the skill catalog to 21 populated skills, hoists the.claude/commands/,.github/prompts/, anddocs/workbay/templates/surfaces, and splits thedocs/workbay/contracts/directory so only the six agent/agentic contracts ship in the hoisted surface (the consumer-specific contracts were removed).v0.1.0was extracted from the first consumer repository snapshot used to seed this package.
Consumer Setup
The workbay-bootstrap CLI handles the clone + symlink +
overlay-manifest write cycle for consumers. Consumer repos may publish
repo-local setup notes that point back to this package.
1 maintainer
Metadata
1 maintainer
Release files for workbay-system 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| workbay_system-0.2.1.tar.gz | 596.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| workbay_system-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.4 MB
Release files / workbay_system-0.2.1.tar.gz
| Download URL | workbay_system-0.2.1.tar.gz |
|---|---|
| Size | 596.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a455e6f15cddc10494bb54dfa0737ba39785e37be1dabc5c73b3788e0c6ffcc9
|
|
BLAKE2b-256 checksum How to use checksums |
050a1daa2eeff8c304779b24321a5a2ae8f48df290271d311c257e54042132ec
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
Release files / workbay_system-0.2.1-py3-none-any.whl
| Download URL | workbay_system-0.2.1-py3-none-any.whl |
|---|---|
| Size | 756.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d30827fca47d59c4913a9c26f4fac0a9a9ca8dffd79605f0cc3aee7393a9f073
|
|
BLAKE2b-256 checksum How to use checksums |
f3373b65e36890899f473a0873dd216b727a2d810495cab285611c31a85d564c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.13
|
