Brali Agent Skill · practical · usable

Write an Actionable QA Report Another Person Can Use

Turn a vague defect report into a compact handoff that distinguishes what was observed from what is suspected and gives the receiver enough context to reproduce, investigate, and verify the fix.

AgentSkills.iopracticalusableError PreventionClear Communication
Open SKILL.mdCanonical recordVerification JSONAll Agent Skills

Portable instruction

What the agent should do

Write a one-line observed problem and context, add the smallest reliable reproduction sequence, attach the relevant evidence while removing secrets and personal data, label any suspected cause as a hypothesis, state the expected behavior, and define a narrow acceptance check for the fix.

Check-in

Can another person see what happened, reproduce or investigate it, distinguish fact from hypothesis, and know what would count as fixed?

Install

One portable file, host-specific location.

Inspect SKILL.md first. The evidence state and skill mode are part of the contract.

Install for normal use.

Claude Code

Drop into a skill folder

Personal: ~/.claude/skills/qa-clear-feedback-templates/SKILL.md
Project: .claude/skills/qa-clear-feedback-templates/SKILL.md

Claude Agent Skills docs

Hermes Agent

Install directly from this URL

hermes skills install https://brali-lifeos.github.io/skill-packs/qa-clear-feedback-templates/SKILL.md

Hermes skills docs

OpenClaw

Place in a discovered skill root

Workspace: <workspace>/skills/qa-clear-feedback-templates/SKILL.md
Global: ~/.openclaw/skills/qa-clear-feedback-templates/SKILL.md

OpenClaw skills docs

Brali verification

Coverage and trust state are checked together.

Canonical ID: brali:qa-clear-feedback-templates
Evidence state: practical
Skill mode: usable
Recommendation eligible: yes
SHA-256: 7570e6a52c63a34e34a0ba01cd9c28fc6642a41799c004763c91138f4f2692b6

Brali CI verified. This means identity, state, mode, provenance and file integrity matched the generated corpus. It is not third-party vendor endorsement.

Why every hack gets a skill

Brali keeps a one-to-one machine surface: one hack record, one stable skill identity. Trust state determines what the skill is allowed to do.

License

Original Brali knowledge is available for non-commercial reuse under CC BY-NC-SA 4.0. Keep attribution, canonical record link, evidence state and skill mode.