Labs

Personal AI tooling and demo monorepo.

This repository is a workspace for small, reusable experiments that are large enough to keep under version control but not yet independent products. Current work is package-first: shared tools live under packages/, while future standalone demos can live under apps/.

Projects

Project	Description	Stack
packages/skills	Native manifest-based CLI for installing agent skills	TypeScript, Bun

Quick Start

bun install
bun run check
bun run lint

Commands

Command	Description
bun run check	Type-check the workspace with tsc --noEmit
bun run lint	Run Biome checks and write safe fixes
bun run format	Format supported files with Biome
bun run link-package <package>	Link a workspace package binary for local use

Package-specific commands are run with Bun filters:

bun run --filter @plimeor/skills build
bun run --filter @plimeor/skills lint

Repository Layout

apps/            Standalone demos and experiments
packages/        Reusable local tools and libraries
docs/specs/      Living implementation specs
docs/plan/       Date-prefixed implementation plans
docs/decisions/  Date-prefixed historical decision records, created when needed

Conventions

• Specs use stable topic filenames under docs/specs/; plans use date-prefixed filenames under docs/plan/: YYYY-MM-DD-description.md.
• Decision records use date-prefixed filenames under docs/decisions/ when a significant historical decision needs a durable record.
• Every package under packages/ extends the root tsconfig.json.
• Package boundaries, workspace structure, and generated lockfiles should stay stable unless a task explicitly requires changing them.

See packages/skills/README.md for the current package-level usage guide.