opscrew-troubleshoot SKILL.md skillB

opscrew-troubleshoot from softzer0/opscrew is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add softzer0/opscrew/opscrew-troubleshoot@git:20261105.3abd051

Pins git:20261105.3abd051 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
softzer0/opscrew
Path
plugin/skills/opscrew-troubleshoot/SKILL.md
Versions recorded
5
Latest version
git:20261105.3abd051, committed Nov 5, 2026
First version recorded
Oct 31, 2026
Size
11,923 bytes
Repository stars
3
License
Apache-2.0

Find out why an app OpsCrew deployed is failing, slow or using too much, from its status, resource figures, alerts and logs, all read-only with secrets masked, and when a recent release is the cause, how to roll it back in the terminal; with self-hosted monitoring on, how to open its Grafana dashboards and what each shows; and what to change (a larger or smaller server, backups, security updates, tokens about to expire), each proposal with its figures and price. Use when the user asks…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Troubleshooting with OpsCrew

Everything here is read-only: these tools change nothing on the server, in the Portainer or on
Cloudflare. Secrets in log lines arrive masked; never try to recover them.

1. **Status first.** Call `opscrew_status` (with `app` and `environment` when the repository has
   several). Read, in this order:
   - **Components:** which part (`app`, a worker, a cron job, a service such as `db`) is stopped or
     has no container.
   - **Resources (read now):** the server's load against its CPUs, memory used of total, the disk,
     and each container's CPU, memory against its limit, restarts and uptime. On Cloudflare's
     hosting: the last day's requests, errors and CPU time per request against the free plan.
   - **Flags:** each line starting `Warning:` or `High:` says what a figure means and what to do:
     memory at 90% of a limit (the container is stopped and restarted at the limit), the disk at 85%
     or 95%, a restart since the last deploy.
   - **Not available:** figures this target can't give (the host's disk in a Portainer; everything
     on GitHub Pages). Say so; don't guess them.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add softzer0/opscrew/opscrew-troubleshoot@sha256:2d15e9fd0237bd54

The line at the top of this page pins the label git:20261105.3abd051, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vznzn63nqflnahhe.svg)](https://markdownregistry.com/a/art_vznzn63nqflnahhe)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Oct 31, 2026 and Nov 5, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261105.3abd051 latest2026-11-05 3abd051 11,923 BB view · diff
git:20261105.2498d202026-11-05 2498d20 12,079 BB view · diff
git:20261104.b2839232026-11-04 b283923 10,071 BB view · diff
git:20261031.53ecfc62026-10-31 53ecfc6 6,282 BB view · diff
git:20261031.5191d042026-10-31 5191d04 4,359 BB view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No instruction to read or print local credentials (matched: read `.env)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11923 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

softzer0/opscrew · 3 stars · license Apache-2.0 · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vznzn63nqflnahhe
GET https://markdownregistry.com/api/v1/resolve?ref=softzer0/opscrew/opscrew-troubleshoot
GET https://markdownregistry.com/api/v1/blob/2d15e9fd0237bd54d46026c094033c5a8dacffb6c2223654bf5362e984a5281e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from softzer0/opscrew

speckit-analyze SKILL.md skill
softzer0/opscrew · .claude/skills/speckit-analyze/SKILL.md · Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after…
git:20261011.9110376 · audit A · 3 stars
speckit-checklist SKILL.md skill
softzer0/opscrew · .claude/skills/speckit-checklist/SKILL.md · Generate a custom checklist for the current feature based on user requirements.
git:20261011.9110376 · audit A · 3 stars
speckit-clarify SKILL.md skill
softzer0/opscrew · .claude/skills/speckit-clarify/SKILL.md · Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and…
git:20261011.9110376 · audit A · 3 stars
speckit-constitution SKILL.md skill
softzer0/opscrew · .claude/skills/speckit-constitution/SKILL.md · Create or update the project constitution from interactive or provided principle inputs.
git:20261011.9110376 · audit A · 3 stars
speckit-converge SKILL.md skill
softzer0/opscrew · .claude/skills/speckit-converge/SKILL.md · Assess the current codebase against the feature's spec, plan, and tasks, then append any remaining unbuilt work as new…
git:20261011.9110376 · audit A · 3 stars
speckit-implement SKILL.md skill
softzer0/opscrew · .claude/skills/speckit-implement/SKILL.md · Execute the implementation plan by processing and executing all tasks defined in tasks.md
git:20261011.9110376 · audit A · 3 stars
speckit-plan SKILL.md skill
softzer0/opscrew · .claude/skills/speckit-plan/SKILL.md · Execute the implementation planning workflow using the plan template to generate design artifacts.
git:20261011.9110376 · audit A · 3 stars
speckit-specify SKILL.md skill
softzer0/opscrew · .claude/skills/speckit-specify/SKILL.md · Create or update the feature specification from a natural language feature description.
git:20261011.9110376 · audit A · 3 stars
speckit-tasks SKILL.md skill
softzer0/opscrew · .claude/skills/speckit-tasks/SKILL.md · Generate an actionable, dependency-ordered tasks.md for the feature based on available design artifacts.
git:20261011.9110376 · audit A · 3 stars
speckit-taskstoissues SKILL.md skill
softzer0/opscrew · .claude/skills/speckit-taskstoissues/SKILL.md · Deprecated: Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available…
git:20261011.9110376 · audit A · 3 stars
AGENTS.md AGENTS.md file
softzer0/opscrew · AGENTS.md
git:20261011.de4901e · audit A · 3 stars
CLAUDE.md CLAUDE.md file
softzer0/opscrew · CLAUDE.md
git:20261105.04c5244 · audit A · 3 stars

Every file in softzer0/opscrew

Browse by kind, by grade B, or by owner.