Skip to content
cccskills
FreePublished on GitHub

tool-health-smoke

Check each discovered live tool CLI by running its standard `health` command through the sandbox credential path. Review a compact Slack friendly report showing pass, failure, or partial results, with brief evidence for each tool.

OriginalShow the original description

Run a focused Centaur tool health smoke test across every live tool CLI. Use when asked to smoke test tools, check all tool auth/connectivity, validate brokered credential injection, or produce a Slack-ready health report for the current deployment.

paradigmxyz/centaur1,407 stars(GitHub 1,407 + cccskills 0)
Works withSlack

Run score Not tested

See how to install

Good for

  • Checking authentication and connectivity for live tools
  • Validating brokered credential injection
  • Preparing a Slack ready tool health report

Files included (3)

  • SKILL.md2.8 KB
  • agents/openai.yaml215 B
  • scripts/run_tool_health_smoke.py8.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Tool Health Smoke

Overview

Use this skill for broad tool-by-tool smoke checks. It is narrower than the full qa skill: it only verifies that each live tool CLI is installed and that its health command succeeds through the normal sandbox credential path.

Do not invent one-off probes for each tool. The canonical smoke surface is:

<tool> health

Workflow

  1. Run the bundled runner from a sandbox or environment where centaur-tools and tool shims are installed:

    uv run .agents/skills/tool-health-smoke/scripts/run_tool_health_smoke.py
    
  2. The runner discovers tools with centaur-tools json, then executes each <tool> health command with a bounded timeout.

  3. Review the generated Slack-friendly report. The first line is the overall result:

    Overall: PASS|FAIL|PARTIAL - <reason>
    
  4. Return the report in the Slack thread as the assistant response. Do not call the Slack posting API unless the user explicitly asks you to post through the Slack tool.

Report Rules

  • Treat returncode != 0, invalid JSON, missing ok, or ok: false as a failed tool health check.
  • Treat a missing health command as a failure. Tools are expected to expose health.
  • Report the runner output directly. Health commands are responsible for returning compact, safe JSON.
  • Keep evidence compact: include the tool name, status, and one short detail or error.
  • Use Slack mrkdwn bullets, not Markdown tables.
  • Include all failed rows. If all tools pass, include a compact pass list or pass count.

Useful Options

uv run .agents/skills/tool-health-smoke/scripts/run_tool_health_smoke.py --timeout 45
uv run .agents/skills/tool-health-smoke/scripts/run_tool_health_smoke.py --concurrency 4
uv run .agents/skills/tool-health-smoke/scripts/run_tool_health_smoke.py --only slack,websearch,vlogs
uv run .agents/skills/tool-health-smoke/scripts/run_tool_health_smoke.py --json

Use --json only when you need machine-readable results for follow-up analysis. Use the default text output for Slack.

Interpreting Results

  • PASS: every discovered tool health command returned valid JSON with ok: true.
  • FAIL: one or more tools failed, timed out, returned malformed output, or omitted the required health result.
  • PARTIAL: discovery succeeded but no tools were found, or the run was intentionally filtered.

When a tool fails because a credential is missing, check whether the client incorrectly requires an environment variable instead of using secret() or proxy-injected auth.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Investigate authentication, permission, credential, OAuth, token, secret, and API proxy failures by checking live VictoriaLogs evidence first. Summarize relevant status codes and error details, and distinguish upstream denials from local proxy or secret resolution problems.

  • Investigate a 401, 403, or 503 response
  • Trace an integration authentication failure
  • Check why a credential or secret is not resolving
paradigmxyz/centaur1.4KUpdated Oct 26, 2026

centaur

FreeSummary

Use an authenticated Centaur MCP deployment to find and call team-approved tools. It checks identity when permissions matter, follows the deployment’s current CLI help, and summarizes consequential changes with relevant identifiers or links.

  • Finding the right approved Centaur tool
  • Running an unfamiliar Centaur CLI command
  • Checking the signed-in user's permissions
paradigmxyz/centaur1.4KUpdated Oct 26, 2026

Use this skill to translate a Console administrator’s request into Centaur permission changes. It can create supported principals and secrets, grant or revoke access, adjust Slack and sandbox permissions, and manage Slack Connect allowlists while checking for unsafe personal credential sharing.

  • Grant a Slack channel access to a shared tool credential
  • Create a principal for a Slack channel, user, or workflow
  • Adjust a channel’s access to another Slack channel
paradigmxyz/centaur1.4KUpdated Oct 26, 2026

Investigate Centaur incidents using VictoriaLogs for runtime logs and VictoriaMetrics for deployment and health metrics. The skill correlates a narrow time window with relevant code and workflow status, then reports a supported cause or bounded hypotheses and the evidence still needed.

  • Investigating a stalled workflow or missing post
  • Checking thread and execution evidence
  • Reviewing tool-call or sandbox activity
paradigmxyz/centaur1.4KUpdated Oct 26, 2026

company-context

FreeSummary

Answer internal history and project context questions by searching indexed company information and checking relevant live sources such as Slack, Linear, Google Docs, Drive, Calendar, or Granola. Reconcile the evidence and cite dates or source links when available.

  • Find what was discussed or decided internally
  • Check a project's prior context or current status
  • Search meeting notes and calendar events
paradigmxyz/centaur1.4KUpdated Oct 26, 2026

creating-tools

FreeSummary

Build a new external service integration as a packaged Python CLI. The skill guides the project layout, API client, command-line interface, credential declarations, health check, and tests so the tool can be installed and used by agents.

  • Create a tool for a new external API
  • Build a Python client for a service
  • Add a CLI command for an integration
paradigmxyz/centaur1.4KUpdated Oct 26, 2026

See all skills by paradigmxyz

Report a problem with this skill