skills.rest
aifuun
aifuunCOMMUNITY
Explore all skills by this author →
GitHub

preflight-check

Validate git state, GitHub CLI auth, and dependencies before issue workflows.

Updated Mar 8, 2026
Search Tags:#git#github#permissions#auto-fix#nodejs#preflight#environment-check
One-click install
npx skills add https://github.com/aifuun/u-safe-archive --skill preflight-check-aifuun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: preflight-check
Source: https://github.com/aifuun/u-safe-archive/tree/main/.claude/skills/preflight-check
Command: npx skills add https://github.com/aifuun/u-safe-archive --skill preflight-check-aifuun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill validates and fixes repository and environment configuration before automated work-issue workflows to prevent mid-execution failures and reduce manual interruption.

Core Features & Use Cases

  • Comprehensive checks: validates permissions, framework directories, git repository and branch, working directory cleanliness, GitHub CLI authentication, project structure, dependencies, and quality tool scripts.
  • Safe auto-fix and priorities: applies fast safe fixes (create directories, create .gitignore), confirmable fixes (git stash, npm install), and surfaces manual actions (gh auth login) when required.
  • Parallel execution and clear reporting: groups checks for parallel execution, aggregates results, and emits READY / WARNINGS / BLOCKED reports to gate subsequent workflows.
  • Use case: run before starting an automated issue workflow or a batch of issues to ensure CI/PR operations and local tooling will succeed without interruptions.

Quick Start

Run the preflight-check to validate and automatically fix common repository and environment issues before starting a work-issue.

Frequently Asked Questions about preflight-check

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate git state and environment configuration before running an automated workflow?▼

Preflight checks validate git repository state, branch status, and environment configuration before executing automated workflows. This process inspects working directory cleanliness and GitHub CLI authentication to prevent mid-workflow interruptions and ensure CI operations succeed.

Can I automatically fix common repository issues like missing directories or uncommitted changes during a preflight check?▼

Yes, priority-based auto-fixes can safely create missing directories and .gitignore files, or apply confirmable fixes like git stash and npm install. Manual actions such as gh auth login are surfaced when required, ensuring safe environment validation before proceeding.

What is the best way to prevent CI pipeline failures caused by missing dependencies or invalid permissions?▼

Running parallelized preflight checks for dependency installation, permission configuration, and project structure validation prevents CI pipeline failures. This approach emits READY, WARNINGS, or BLOCKED reports to gate subsequent workflows and avoid mid-execution breakdowns.

Does preflight environment checking work with Node.js projects and GitHub CLI authentication?▼

Yes, preflight environment checking supports Node.js workflows by validating dependency installation and project structure. It also verifies GitHub CLI authentication status, surfacing manual login actions if permissions are insufficient for automated issue processing.

Why does my automated issue workflow get blocked by dirty git state or missing framework directories?▼

Automated workflows get blocked when preflight checks detect uncommitted changes or missing required directories. The validation process groups these checks, applying safe auto-fixes like git stash or directory creation, and emits a BLOCKED report if manual intervention is needed.

Related Skills

Explore More Software Engineering Skills→
continuedevcontinuedev
35.4k

cn-check

Run the Continue CLI locally to check working tree changes with Node.js 18+.

Official
Intermediate
lhpaullhpaul
9

workflow-reviewer-loop

Automate GitHub PR review and CI verification workflows.

Community
Advanced
williamzujkowskiwilliamzujkowski
17

nist

Map systems to NIST controls and generate implementation plans.

Community
Advanced
gwpjpgwpjp
3

verify

Runs typecheck, lint, prettier, and build to produce a pass/fail report.

Community
Advanced