Skip to content

softschema 0.1.1

Choose a tag to compare

View all tags
@jlevy jlevy released this 29 May 21:25
· 110 commits to main since this release
v0.1.1
f5d65ed

Documentation and skill polish patch. No API or CLI behavior changes beyond a tightened --help epilog.

Changes

  • README: reframed softschema as both a Markdown+YAML spec and the matching softschema CLI (not just a Python package). Wove in three themes — combining prose and structure is more context-efficient and more flexible than splitting them; each YAML promotion buys efficiency for a downstream consumer, so structure and efficiency grow together; structure added before a consumer needs it costs more than leaving it loose, because a contract with consumers is harder to loosen than prose is to tighten. Added an explicit coding-agent pipeline angle: agents call the softschema CLI to test and validate the code, docs, and data they produce alongside their usual linters, tests, and type checkers.
  • Skill (skills/softschema/SKILL.md): trimmed from ~110 lines to ~55 — a minimal routing layer per the cli-agent-skill-patterns guideline. Description follows the two-part rule (what + when) with trigger keywords front-loaded. Body points at softschema skill --brief and softschema docs <topic> instead of duplicating guide/spec content. Installed repo-local mirrors at .agents/skills/softschema/ and .claude/skills/softschema/ with DO NOT EDIT markers, derived deterministically from the canonical source.
  • CLI: strengthened the softschema --help epilog with an IMPORTANT prefix and the three key doc topics named inline (guide, spec, example-artifact).
  • Flowmark-formatted touched docs; regenerated the movie example marker after format drift.

Installation

```bash
pip install softschema==0.1.1

or:

uvx softschema@0.1.1 --help
```

Assets 2
Loading