agentleFS
hussainatyhussainaty/ai-agent-skills/skills/workflow-preflight/SKILL.md

workflow-preflight

Skill1 starsChanged 32 days agoMITView on GitHub

Route a substantive coding, research, cross-agent, or production request before work begins. Select the smallest compatible set of installed skills, or explicitly conclude that no specialized skill is needed; discover an online skill only for a real capability gap. Use before work that may benefit from repository context, public research, implementation, verification, or external systems. Do not use for a direct factual answer, simple calculation, or isolated rewrite.

The file

We split this skill into the rules it gives an agent

8 rules. About 0 are common, 6 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  • could be automatic: a setting could enforce it
  1. Distinctive:

    Run this preflight before starting substantive work.

    line 8
  2. Distinctive:

    Read the full instructions only for that shortlist.

    line 24
  3. Very specific:

    Use agent-workflow-pipeline when the task combines repository context, public research, implementation, optional model routing, and …

    line 31
  4. Distinctive:

    Treat it as the coordinator.

    line 33
  5. Distinctive:

    Only if no selected skill covers a material capability, read skill-discovery.md.

    line 35
  6. Distinctive:

    Use evaluation.md when changing this skill or checking its routing behavior.

    line 40
  7. Very specific:

    Every task that passes step 1 runs on the working-context-notebook flow.

    line 47
  8. Distinctive:

    Read the accepted revision back after any context compaction and before the final answer.

    line 55

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Workflow Preflight

Run this preflight before starting substantive work. Its purpose is to improve the main task by selecting the right capabilities, not to load every available skill or delay straightforward work with unnecessary research.

Select skills before acting

  1. Identify the outcome, target environment, data sensitivity, external systems, and evidence needed to call the task complete. Stop here for a direct answer, calculation, or isolated rewrite: no specialized skill is needed.
  2. Make a provisional shortlist from the available-skills metadata. Prefer the published inventory; for a workspace, also check project roots such as .agents/skills/, .claude/skills/, .opencode/skills/, and .hermes/skills/. Limit the shortlist to the few capabilities that plausibly cover a material part of the task. Never select a route whose skill or required tool is unavailable in the current runtime.
  3. Read the full instructions only for that shortlist. Select the smallest compatible set based on coverage, sequencing, available tools and access, and the cost of extra setup. A group of skills must work together for this request; individually relevant skills can still be redundant or conflict.
  4. State the route in one short line, such as Preflight: graphify + product-quality-loop — architecture context and verified implementation. Then begin the main task in the same turn.
  5. Use agent-workflow-pipeline when the task combines repository context, public research, implementation, optional model routing, and verification. Treat it as the coordinator; do not separately load a component skill when the pipeline already owns that phase.
  6. Only if no selected skill covers a material capability, read skill-discovery.md. Recommend a verified candidate, but do not install it, connect a service, or add credentials without the user's explicit authorization.

Use evaluation.md when changing this skill or checking its routing behavior. The test cases separate trigger accuracy from route quality, so a broad description does not turn into indiscriminate skill loading.

Open the working context

Every task that passes step 1 runs on the working-context-notebook flow. It is the default working flow, not a route to select, so it does not count toward the smallest skill set and is not named in the route line.

  • Open the notebook as soon as the route is stated. Put the outcome in the goal and the completion evidence from step 1 in the tracker.
  • While the selected skills run, log long raw output, keep exact values as sourced facts, and accept an edit at each phase or gate.
  • Read the accepted revision back after any context compaction and before the final answer.

Skip it only where step 1 stops: a direct answer, a calculation, or an isolated rewrite.

Common local routes

  • Repository architecture, file relationships, or codebase questions: graphify.
  • Current public facts or structured source research: scrapegraphai-research.
  • Platform content (YouTube, GitHub, Reddit, Twitter/X, Bilibili, RSS), or installing or updating Agent Reach: scrapegraphai-research (see scrapegraphai-research's references/agent-reach.md).
  • User-authorized feature work, fixes, or release preparation: product-quality-loop.
  • Coder workspace or TrueForge handoff: remote-agent-graphify.
  • Cross-agent work that needs several of the routes above: agent-workflow-pipeline.
  • Building or substantially extending a product end to end (research, questions, jury-reviewed tasks, testing, integration, graph, memory): engineering-workflow.
  • Profiling or prioritizing clients from a CRM export: client-profiling.
  • Browser interaction or web-app testing: agent-browser.
  • A repeatable end-to-end test suite for a web or mobile app: npx e2e init through product-quality-loop (see product-quality-loop's references/e2e-testing.md). It installs packages, a skill, and an MCP entry, so treat it as an install that needs the user's go-ahead unless they asked for it.
  • Frontend design or UX work: impeccable.
  • Security assessment: application-security-testing.

These are starting points. Use the task wording and each skill description to make the final selection, including other installed skills that fit better.

Keep the main task moving

Preflight is complete once the selected skill set is clear. Continue into the main task immediately. When an online candidate would materially improve the result, present its source, reputation signals, scope, and installation command as a recommendation, then wait for the user to ask for installation.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.