LangBot Skills Maintenance
Use this skill before changing reusable assets in this repository.
Workflow
- Read
AGENTS.md,skills/.env, and the relevant existing skill files. - Classify the change:
SKILL.mdfor routing and concise operating rules.references/*.mdfor canonical detailed workflows.cases/*.yamlfor executable test-plan skeletons.suites/*.yamlfor reusable groups of case ids.fixtures/fixtures.jsonfor deterministic fixture readiness metadata.reports/evidence/<run-id>/automation-result.jsonas automation output andreports/evidence/<run-id>/result.jsonas final judgment output; neither is a catalog asset to commit.troubleshooting/*.yamlfor one reusable failure mode.
- Search existing assets before adding new files:
rg "<feature|error|case id>" skillsbin/lbs case listbin/lbs suite listbin/lbs fixture list
- Put detail in one canonical place and link to it from cases or routing bullets.
- Run the checks in
AGENTS.mdafter edits.
Entropy Rules
- Prefer extending an existing reference or troubleshooting entry when the root cause is the same.
- Keep cases short: setup, action, evidence, pass/fail checks. Do not paste long prompts or debug transcripts when a reference exists.
- Put machine-checkable inputs in
env,automation_env, or fixtures; put operator-confirmed assumptions inpreconditionssotest plancan surfacemanual_check. - Keep suites short: title, intent, tags, and ordered case ids. Do not duplicate case steps inside a suite.
- Keep fixture manifests factual: id, title, path, kind, and related case ids. Do not encode environment-specific absolute paths.
- Keep troubleshooting entries narrow: symptoms, patterns, likely causes, fixes, related assets.
- Do not hardcode local ports, browser profile paths, secrets, tokens, or provider keys.
- Use
bin/lbs index --checkto verify the committed index is current without writing it; runbin/lbs indexwhen the index needs regeneration.
For periodic repository audits, read references/curation-workflow.md.