gh-fix-ci
Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions. Use the GitHub app from this plugin for PR metadata and patch context, and use `gh` for Actions check and log inspection before implementing any approved fix.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-06
- Stars
- ★ 98
- Forks
- 39
01 前言 Front Matter
- name
- gh-fix-ci
- description
- Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions. Use the GitHub app from this plugin for PR metadata and patch context, and use `gh` for Actions check and log inspection before implementing any approved fix.
02 资源文件 5
- 参考文档agents/openai.yaml330 B
- 资产文件assets/github-small.svg853 B
- 资产文件assets/github.png1.8 KB
- 许可证LICENSE.txt10.5 KB
- 脚本scripts/inspect_pr_checks.py14.9 KB
03 SKILL.md 正文
GitHub Actions CI Fix
Overview
Use this skill when the task is specifically about failing GitHub Actions checks on a pull request. This workflow is hybrid by design:
- Use the GitHub app from this plugin for PR metadata, changed files, and review context.
- Use
ghfor GitHub Actions checks and logs because the connector does not expose that workflow end to end. - Summarize the root cause first, propose a focused fix plan, and implement only after explicit approval.
Prereq: authenticate with GitHub CLI once, then confirm with gh auth status. Repo and workflow scopes are typically required for Actions inspection.
Inputs
repo: path inside the repo (default.)pr: PR number or URL (optional; defaults to current branch PR)ghauthentication for the repo host
Quick start
python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>"- Add
--jsonif you want machine-friendly output for summarization.
Workflow
- Verify gh authentication.
- Run
gh auth statusin the repo. - If unauthenticated, ask the user to run
gh auth login(ensuring repo + workflow scopes) before proceeding.
- Run
- Resolve the PR.
- If the user provides a PR number or URL, use that directly.
- Otherwise prefer the current branch PR with
gh pr view --json number,url. - When repo and PR are known, fetch PR metadata and patch context through the GitHub app from this plugin.
- Inspect failing checks (GitHub Actions only).
- Preferred: run the bundled script (handles gh field drift and job-log fallbacks):
python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>"- Add
--jsonfor machine-friendly output.
- Manual fallback:
gh pr checks <pr> --json name,state,bucket,link,startedAt,completedAt,workflow- If a field is rejected, rerun with the available fields reported by
gh.
- If a field is rejected, rerun with the available fields reported by
- For each failing check, extract the run id from
detailsUrland run:gh run view <run_id> --json name,workflowName,conclusion,status,url,event,headBranch,headShagh run view <run_id> --log
- If the run log says it is still in progress, fetch job logs directly:
gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs" > "<path>"
- Preferred: run the bundled script (handles gh field drift and job-log fallbacks):
- Scope non-GitHub Actions checks.
- If
detailsUrlis not a GitHub Actions run, label it as external and only report the URL. - Do not attempt Buildkite or other providers; keep the workflow lean.
- If
- Summarize failures for the user.
- Provide the failing check name, run URL (if any), and a concise log snippet.
- Call out missing logs explicitly and do not over-claim certainty.
- Propose a focused fix plan and wait for approval.
- Keep the plan tied directly to the failing checks and the observed root cause.
- Implement after approval.
- Apply the approved fix locally.
- Run the most relevant local verification available.
- Recheck status and summarize residual risk.
- Suggest re-running the relevant tests and
gh pr checks. - Report what is still unverified, what may still be flaky, and whether any failing checks were external and therefore not actionable here.
- Suggest re-running the relevant tests and
Bundled Resources
scripts/inspect_pr_checks.py
Fetch failing PR checks, pull GitHub Actions logs, and extract a failure snippet. Exits non-zero when failures remain so it can be used in automation.
Usage examples:
python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "123"python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "https://github.com/org/repo/pull/123" --jsonpython "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --max-lines 200 --context 40
Guardrails
- Do not imply that the GitHub app can replace
ghfor Actions log retrieval. - Treat non-GitHub Actions providers as report-only unless the user explicitly wants a separate investigation path.
- If the failure is clearly unrelated to the local diff, say so before proposing code changes.
04 同仓库更多 Skills
xiaoyi-pdf-win
PDF 综合处理技能,处理文档生成、编辑、安全与解析。 适用情形: 1. 创建与排版:从零生成报告、提案、简历等 PDF,或对现有文档重新排版美化; 2. 表单与水印:自动填写 PDF 表单字段,或添加文字/图片水印(如打水印、标机密); 3. 页面管理:合并多个 PDF,或拆分、提取指定页码; 4. 安全控制:为 PDF 添加密码(加密)或移除密码(解密); 5. 内容提取:从 PDF 中提取纯文本或导出表格数据。 只要用户诉求涉及生成、排版、美化、转换、拼接、拆分 PDF,或处理水印、表单、密码,必须触发本技能。
skill-creator-win
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
markitdown-win
Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.
minimax-docx
Professional DOCX document creation, editing, and formatting using OpenXML SDK (.NET). Three pipelines: (A) create new documents from scratch, (B) fill/edit content in existing documents, (C) apply template formatting with XSD validation gate-check. MUST use this skill whenever the user wants to produce, modify, or format a Word document — including when they say "write a report", "draft a proposal", "make a contract", "fill in this form", "reformat to match this template", or any task whose final output is a .docx file. Even if the user doesn't mention "docx" explicitly, if the task implies a printable/formal document, use this skill.
skillhub-daily
SkillHub 每日推荐 - 扫描 skillhub.cn 全站 Top100 + 7 大分类各 Top20(共 240 个 Skill), 基于用户痛点精准推荐高价值 Skill,支持 IMA/飞书/Obsidian 多通道存储。 触发词:每日推荐、SkillHub 日报、潜力Skill、帮我推荐技能。 支持两种使用模式:常规 Skills 模式(对话触发)/ Cron 定时任务模式。
deep-research
Structured deep research workflow with human-in-the-loop control. Use /research to generate research outline, /research-deep for parallel web search across items, /research-report to compile markdown reports. Supports academic research, benchmark research, technology selection, market analysis, and due diligence. Triggers: 'deep research', 'research topic', 'benchmark comparison', 'technology survey', 'market analysis'. Requires: WebSearch capability.