← Back to Skills Marketplace
felipefreitag

Manual QA

by felipefreitag · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
123
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install manual-qa
Description
Generate a manual QA checklist from code changes. Use when the user wants to test a PR, commit, branch, or staged changes — or says "QA this", "test plan", "...
README (SKILL.md)

Manual QA

Generate a step-by-step QA checklist from code changes, separating what the agent can verify in the terminal from what needs a human.

Determine the change source

Use the first match:

  1. Argument is a PR URL or number → gh pr diff
  2. Argument is a commit SHA → git show
  3. Staged changes exist → git diff --cached
  4. Current branch differs from main → git diff main...HEAD
  5. Unstaged changes exist → git diff

If nothing matches, tell the user there are no changes to QA.

Analyze the changes

Read the diff carefully. Understand what the change does — not just what files changed, but the intent. Look at:

  • What behavior is being added, modified, or removed
  • What inputs the changed code accepts
  • What side effects it has (API calls, file writes, database changes, UI updates)
  • What could go wrong

Output the QA checklist

Produce a numbered list of concrete test steps. Each step should be specific enough that someone unfamiliar with the code could follow it. Group by feature area if the change spans multiple concerns.

For each step, mark it:

  • 🤖 Agent can test — The agent can run this in the terminal right now. CLI commands, scripts, API calls with curl, file assertions, running test suites, checking build output.
  • 👤 Human must test — Requires a human. Interactive prompts (TTY-dependent), authenticated web sessions, visual/UI verification, multi-step flows across web + email + mobile, anything needing a browser the agent doesn't control, real-device testing.

Include both:

  • Happy paths — the change works as intended with normal inputs
  • Error paths — bad inputs, missing config, network failures, edge cases, permission errors

Offer to run agent-testable steps

After presenting the checklist, offer to run all 🤖 steps. If the user agrees, run them and report results inline — pass/fail for each, with output on failure.

Keep it practical

  • Don't generate steps for things the diff clearly doesn't affect
  • Don't suggest running the full test suite unless the change is broad — suggest targeted tests
  • If the project has a test command (in package.json, Makefile, etc.), use it
  • For bug fixes, include a step that reproduces the original bug and confirms it's fixed
  • For new features, include a step that exercises the feature end-to-end
Usage Guidance
This skill's instructions are coherent for generating QA checklists, but the metadata omits practical requirements. Before installing or invoking it: 1) Verify the runtime environment has git and the GitHub CLI (gh) if you expect PR diff support; otherwise the agent will fail on PR URLs. 2) Understand that using gh pr diff or API calls typically requires GitHub authentication (gh auth or a token); the skill does not declare or request credentials — decide how you'll provide them and whether that's acceptable. 3) Be prepared for the agent to read repository files and run commands/tests if you accept its offer to "run 🤖 steps"; run such actions in a safe or CI-like environment if you have security concerns. 4) If you want to proceed, ask the skill author (or update the metadata) to declare required binaries and any environment variables (e.g., GITHUB_TOKEN) so you can evaluate permission needs accurately.
Capability Analysis
Type: OpenClaw Skill Name: manual-qa Version: 1.0.0 The manual-qa skill is a standard utility designed to help developers generate and execute QA checklists based on code changes. It uses legitimate tools like git and the GitHub CLI (gh) to analyze diffs and suggests relevant testing steps. There are no indicators of malicious intent, data exfiltration, or unauthorized execution patterns in SKILL.md or _meta.json.
Capability Assessment
⚠ Purpose & Capability
The SKILL.md explicitly instructs the agent to run git and GitHub CLI commands (gh pr diff, git show, git diff, etc.) and to detect project test commands (package.json, Makefile). However, the skill metadata lists no required binaries or credentials. Either the metadata is incomplete (omitted needed tools/creds) or the instructions assume capabilities the environment may not provide.
✓ Instruction Scope
The runtime instructions stay within the stated purpose (generate a QA checklist from code changes and offer to run agent-testable steps). They explicitly limit scope (only run steps relevant to the diff, prefer targeted tests). The instructions do require reading repository files and running commands locally or calling APIs, which is reasonable for this purpose.
✓ Install Mechanism
There is no install spec (instruction-only), so nothing is written to disk by the skill itself. This is lower risk and consistent with an instruction-only QA helper.
⚠ Credentials
Although the skill declares no required environment variables, the instructions implicitly require authenticated access to GitHub (gh CLI) for PR diffs and may need network access for curl/API calls. The absence of declared credentials (e.g., GH_TOKEN or gh auth) is a proportionality mismatch that could hide implicit credential needs.
✓ Persistence & Privilege
The skill is not marked always:true and does not request persistent presence or modify other skills' configs. Autonomous invocation is allowed (the platform default); that is expected for a tool that can run commands, but users should be aware the agent could execute terminal steps if permitted.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install manual-qa
  3. After installation, invoke the skill by name or use /manual-qa
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial publish
Metadata
Slug manual-qa
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Manual QA?

Generate a manual QA checklist from code changes. Use when the user wants to test a PR, commit, branch, or staged changes — or says "QA this", "test plan", "... It is an AI Agent Skill for Claude Code / OpenClaw, with 123 downloads so far.

How do I install Manual QA?

Run "/install manual-qa" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Manual QA free?

Yes, Manual QA is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Manual QA support?

Manual QA is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Manual QA?

It is built and maintained by felipefreitag (@felipefreitag); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments