← Back to Skills Marketplace
ivanmmm

Preflight Checks

by IvanMMM · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
1541
Downloads
1
Stars
4
Active Installs
1
Versions
Install in OpenClaw
/install preflight-checks
Description
Test-driven behavioral verification for AI agents. Catches silent degradation when agent loads memory but doesn't apply learned behaviors. Use when building agent with persistent memory, testing after updates, or ensuring behavioral consistency across sessions.
Usage Guidance
What to check before installing/running: 1) Inspect the two scripts (init.sh and add-check.sh) — they copy templates into whatever directory you run them from and will update AGENTS.md and scoring text. Run them in a safe/test workspace or set WORKSPACE_DIR to a controlled folder, and back up AGENTS.md and memory files first. 2) SKILL.md mentions run-checks.sh, sessions_list, and a message CLI, but run-checks.sh is not included and those CLIs are not declared; if you plan to automate checks you must verify those tools exist and what permissions they have. 3) The documentation and example answers include behavioral rules that encourage the agent to act autonomously (e.g., sending Telegram messages without asking). That is a policy/operational choice — only enable automated runs if you are comfortable with that autonomy. 4) The README suggests cloning a GitHub repo (external source) — if following that path, review the repository contents and history before executing any scripts. 5) Sed -i and grep/sed usage may be platform-dependent (macOS vs Linux); test on your platform. Overall the package appears to implement what it claims, but the above mismatches and autonomy guidance make it worth manual review and cautious deployment.
Capability Analysis
Type: OpenClaw Skill Name: preflight-checks Version: 1.0.0 The OpenClaw AgentSkills skill bundle 'preflight-checks' is designed for test-driven behavioral verification of AI agents. The `SKILL.md` and `README.md` provide clear instructions for the agent to perform self-checks, which are aligned with its stated purpose and do not contain any prompt injection attempts to subvert the agent. The shell scripts (`init.sh`, `add-check.sh`) perform benign local file operations (copying templates, modifying markdown files) within the workspace to set up and manage these checks. Crucially, the `examples/ANSWERS-prometheus.md` file explicitly instructs the agent *not* to save user data (emails, names) and to *ask permission* before posting to public channels, demonstrating a clear intent to promote secure and responsible agent behavior rather than malicious activity. No evidence of data exfiltration, malicious execution, persistence, obfuscation, or supply chain attacks was found.
Capability Assessment
Purpose & Capability
The skill's name/description (behavioral pre-flight tests) matches the provided templates and scripts (init.sh, add-check.sh, CHECKS/ANSWERS templates). However SKILL.md references other runtime artifacts/tools (run-checks.sh, a 'message' CLI, sessions_list) and suggests cloning a GitHub repo even though the registry lists source as unknown — the skill does not declare those external tools as required, which is an incoherence to be aware of.
Instruction Scope
Runtime instructions are mostly limited to reading/writing workspace files (PRE-FLIGHT-CHECKS.md, PRE-FLIGHT-ANSWERS.md, AGENTS.md) and having the agent compare answers. But examples/instructions also instruct the agent to call session tooling (sessions_list) and send Telegram messages (message CLI) and to run a run-checks.sh that is not present in the package; those broaden the scope beyond simple file-based tests and are not declared up front.
Install Mechanism
There is no install spec (instruction-only with included scripts). No downloads or remote installers are required by the package itself. Note: SKILL.md includes a manual git clone example pointing to a third‑party GitHub URL; if you follow that path you will fetch code from an external host — consider verifying the repository first.
Credentials
The skill declares no required environment variables or credentials, which fits a file-based testing tool. The scripts do use WORKSPACE_DIR (defaulting to current working directory) and will modify files in that directory; they also reference external CLI tools in examples (message, sessions_list) without declaring them. That mismatch between declared env/binaries and real instructions is worth noting.
Persistence & Privilege
always:false (no forced persistence). The provided scripts will write/overwrite files in the user's workspace (copy templates, update AGENTS.md, insert checks, edit scoring via sed). Modifying AGENTS.md is effectively changing agent startup behavior — this is within the skill's claimed scope but is a privileged action so you should review changes and keep backups.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install preflight-checks
  3. After installation, invoke the skill by name or use /preflight-checks
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: behavioral verification framework for AI agents
Metadata
Slug preflight-checks
Version 1.0.0
License
All-time Installs 4
Active Installs 4
Total Versions 1
Frequently Asked Questions

What is Preflight Checks?

Test-driven behavioral verification for AI agents. Catches silent degradation when agent loads memory but doesn't apply learned behaviors. Use when building agent with persistent memory, testing after updates, or ensuring behavioral consistency across sessions. It is an AI Agent Skill for Claude Code / OpenClaw, with 1541 downloads so far.

How do I install Preflight Checks?

Run "/install preflight-checks" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Preflight Checks free?

Yes, Preflight Checks is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Preflight Checks support?

Preflight Checks is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Preflight Checks?

It is built and maintained by IvanMMM (@ivanmmm); the current version is v1.0.0.

💬 Comments