Skip to main content

workbay-system

Component of the workbay stack. You usually install workbay, 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.0 was extracted from a consumer repository snapshot. It expands the skill catalog to 21 populated skills, hoists the .claude/commands/, .github/prompts/, and docs/workbay/templates/ surfaces, and splits the docs/workbay/contracts/ directory so only the six agent/agentic contracts ship in the hoisted surface (the consumer-specific contracts were removed).
  • v0.1.0 was 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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

workbay_system-0.2.1.tar.gz (596.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

workbay_system-0.2.1-py3-none-any.whl (756.8 kB view details)

Uploaded Python 3

File details

Details for the file workbay_system-0.2.1.tar.gz.

File metadata

  • Download URL: workbay_system-0.2.1.tar.gz
  • Upload date:
  • Size: 596.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for workbay_system-0.2.1.tar.gz
Algorithm Hash digest
SHA256 a455e6f15cddc10494bb54dfa0737ba39785e37be1dabc5c73b3788e0c6ffcc9
MD5 4dd34451a4e48d5ec2af99ffe82d24ed
BLAKE2b-256 050a1daa2eeff8c304779b24321a5a2ae8f48df290271d311c257e54042132ec

See more details on using hashes here.

File details

Details for the file workbay_system-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: workbay_system-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 756.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for workbay_system-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d30827fca47d59c4913a9c26f4fac0a9a9ca8dffd79605f0cc3aee7393a9f073
MD5 857e1f732a3f7d9be1997fcbe385564c
BLAKE2b-256 f3373b65e36890899f473a0873dd216b727a2d810495cab285611c31a85d564c

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page