An Openclaw Skills workflow that forces you to search upstream issues and releases before writing custom workarounds for open-source bugs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oss-issue-first
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install oss-issue-first using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Open Source Issue-First Workflow?
Openclaw Skills' issue-first workflow helps AI coding agents and developers resolve open-source bugs faster by checking the project's GitHub/GitLab issue tracker, pull requests, and latest release before touching configs or code. It is designed to prevent the common trap of spending hours on custom workarounds for a problem that upstream already fixed.
Use this skill when a third-party package or app starts returning unexpected errors or behavior: first confirm the repo, then confirm the version, then verify whether a fix has already landed. If the issue is already resolved upstream, the correct response is to upgrade; if not, move into targeted debugging with a clean evidence trail.
Open Source Issue-First Workflow Use Cases
- You hit HTTP 401/403/404 responses from an open-source dependency or service.
- The browser console shows CORS or SecurityError messages.
- A library's API behaves differently than documented or expected.
- A feature seems missing and "should" exist in the upstream project.
- Errors appear immediately after upgrading a dependency.
- You are about to add proxy rules, referer hacks, or config workarounds and want to check upstream first.
- You need to triage projects like RAGFlow, SpringAI, RuoYi, Vue, or Element Plus.
How Open Source Issue-First Workflow Works
- Identify the project, upstream repository, and the version currently in use.
- Search the issue tracker and pull requests with the exact error keywords.
- Check whether the issue is marked fixed, merged, or released, and note the commit, tag, or version.
- Compare the fixed version with the user's version to see whether an upgrade solves the problem.
- Only if the issue is unreported, unfixed, or the version is locked, begin custom debugging and controlled workarounds.
- Report the evidence back to the user: issue URL, PR URL, fix version, and whether upgrading is feasible.
Open Source Issue-First Workflow Setup
No package installation is required; this skill is a workflow, not a runtime dependency. Enable web access and shell access, then use the repo's own metadata to triage the problem.
- Identify the upstream repo from
package.json,pom.xml, the error message, or the project docs. - Confirm the current version and locate the latest release or tag.
- Search issues and PRs before changing code or configuration.
- If needed, use the API or web search to validate the fix status.
curl -s 'https://api.github.com/search/issues?q=repo:{org}/{repo}+{keywords}+state:all&sort=updated&order=desc' | head -100
curl -s 'https://api.github.com/repos/{org}/{repo}/releases/latest'
For GitLab or Gitee projects, use the equivalent issue tracker and release pages when the GitHub API is not available.
Open Source Issue-First Workflow Data Schema & Taxonomy
The skill does not generate local files; it produces a diagnosis record in-chat and relies on existing repository metadata.
| Field | Type | Source | Purpose |
|---|---|---|---|
| project_name | string | repo/docs | Human-readable name of the upstream project |
| repo_url | string | GitHub/GitLab/Gitee | Upstream repository to inspect |
| current_version | string | package.json, pom.xml, lockfiles, release notes |
Baseline for version comparison |
| error_keywords | string[] | stack trace, browser console, logs | Search terms used in issue/PR queries |
| issue_url | string | issue tracker | Matching issue, if any |
| pr_url | string | pull/merge request | Matching fix implementation, if any |
| fix_status | enum | tracker metadata | open, fixed, merged, released, not_found |
| fix_version | string | release notes/tag | First version containing the fix |
| fix_commit | string | commit history | Exact merged change, when available |
| upgrade_feasible | boolean | release policy / environment constraints | Whether the user can upgrade |
| decision | string | analysis | upgrade, wait, or debug/workaround |
Metadata taxonomy
- Source artifacts: issue, PR/MR, release, tag, manifest, stack trace.
- Resolution labels: reported, fixed, merged, released, unfixed, not found.
- Action labels: upgrade now, wait for release, or continue custom debugging.
Open Source Issue-First Workflow Advanced Features
- Upstream-first gate that blocks premature config hacks, proxy rules, and brittle workarounds.
- API-assisted issue triage with
curlfor fast, repeatable searches. - PR, merge request, and release correlation to identify the exact version that contains the fix.
- Repo discovery from
package.json,pom.xml, lockfiles, or error messages when the project name is unclear. - Multi-agent friendly: one agent can gather upstream evidence while another prepares remediation only if needed.
- Openclaw Skills-compatible evidence logging with issue URLs, fix status, and upgrade guidance.
SKILL.md
Loading
Related Openclaw Skills
AI Music Composer
A professional end-to-end AI music generator that clones your voice and composes complete, personalized songs based on your lyrics and style preferences.
StorageSaver Watcher
StorageSaver Watcher is a read-only Mac disk scanner and monitoring utility that visualizes storage usage through an interactive HTML sunburst chart and provides plain-English safety assessments.
AI Open Source Tech Due Diligence
An Openclaw Skills pipeline that turns GitHub Trending discoveries into deep technical due diligence, WeChat-ready articles, and Feishu knowledge-base docs.
TRPG Abbreviation Wrapper
An idempotent automation tool to safely wrap TRPG rule abbreviations into readable Chinese-English paired formats across Markdown, text, and Excel files.
Voiceover and Narration
Openclaw Skills turns scripts into expressive one-speaker voiceover audio with bracket-based direction, voice selection, and model-aware normalization.
Text in Image Generation
A specialized workflow for generating high-fidelity images with accurate, legible, and styled text layers.
Featured*
