Problem
What problem this solves
Conversations can contain recurring behavior flaws, but ad hoc fixes are hard to compare without durable, standardized evidence.
Menu Open navigation menu Close navigation menu
Audit & Improve
Skill Detail
sg-conversation-audit
Audit exported ShipGlows transcripts for systemic agent flaws and route durable fixes.
A focused audit lane that reads canonical conversation evidence, classifies repeatable failure patterns, and routes recommended owners.
Outcome
What changes when it works
You get a durable audit report tied to evidence, severity, and an explicit owner route.
Why It Matters
What this changes for a solo founder
This skill prevents recurring defects from being resolved only once; it turns fragile transcripts into repeatable improvement work.
When to use it
- When you want recurring conversation quality issues to be classified and routed automatically.
- When you have a recent transcript and need to propose a durable follow-up action.
- When `sg-build` changes need evidence from real conversation behavior.
What you give it
- A path to one or more conversation transcripts.
- An explicit quality policy and routing preference.
What you get back
- A `conversation_audit` artifact in `shipglows_data/workflow/conversation-audits/`.
- Stability-oriented category counts and top findings.
- A direct owner route for actionable failures.
Typical examples
- sg-conversation-audit latest
- sg-conversation-audit path shipglows_data/workflow/conversations/conversation-...
- sg-conversation-audit export shipglows
- sg-conversation-audit report=agent
Limits
- Default mode audits the latest transcript when no explicit path is passed.
- Safe-only gates are strict: unsafe transcripts block public artifact publication.
- No generic code fixes; the skill routes to owners.
Arguments
Some arguments change the workflow, not just the wording.
These are the argument switches documented for this skill. For the general rule behind skill arguments, read the skill modes tutorial.
latest
Audit the latest transcript under shipglows_data/workflow/conversations/.
Consequence
Fast loop for operator-incremental evidence.
path <file-or-dir>
Audit one transcript file or all files in a directory.
Consequence
Useful for backfills and fixture audits.
export shipglows
Capture a fresh transcript through the shipglows preset, then audit it.
Consequence
One-step capture-to-audit flow.
report=agent
Show full evidence table and routing rationale.
Consequence
Use for downstream owner handoff.
Related Skills
See the rest of the loop around this move.
Build & Fix
sg-build
Run non-trivial work from story to spec, build, verification, closeout, and ship without making the user drive every gate.
The master user-facing lifecycle orchestrator for carrying a story, bug, or goal through ShipGlows's spec, readiness, implementation, verification, onboarding consideration, documentation, closure, and shipping gates.
Open skill page Audit & Improve
sg-verify
Check whether the work really satisfies the user story, not just whether the code compiles.
A verification skill for standard readiness or an explicit excellence-focused second pass beyond the task's acceptance criteria.
Open skill page Operate & Ship
sg-docs
Create or repair documentation so the repo stays navigable for both humans and agents.
A documentation skill for maintaining docs, metadata, and governance-layout compliance across project surfaces.
Open skill page Plan & Decide
sg-spec
Turn a fuzzy request into an implementation-ready contract before code starts mutating the repo.
The spec-writing skill for shaping non-trivial work into a clear user story, behavior contract, executable task list, and chantier history.
Open skill pageGo Deeper
This public page explains the move. The repository explains the execution contract.
Use the public catalog for education and workflow selection. Move to the docs and GitHub when you want the operator-grade execution details behind the skill system.