# Skywatch Osprey Validate

> Validate an Osprey SML rules project by running `uv run osprey-cli push-rules --dry-run` from the skywatch-osprey repo and reporting the full result without summarising.

- Skill: `skywatch-bsky/skywatch-osprey-validate` (Agent Skill)
- Install (CLI): `npx skillmds@latest add skywatch-bsky/skywatch-osprey-validate`
- Raw SKILL.md: https://api.skillmd.com/api/skills/skywatch-bsky/skywatch-osprey-validate/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: skywatch-bsky (https://skillmd.com/u/skywatch-bsky)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/skywatch-bsky/skywatch-osprey-validate

---


# Osprey Validate

Validate an Osprey SML rules project by running the osprey-cli dry-run push from
inside the `skywatch-osprey` repository. Report the FULL osprey-cli output —
never summarise, truncate, or omit any errors.

## Resolve the rules project path

Resolution order (first non-empty match wins):

1. An explicit path the caller gave you.
2. The `OSPREY_RULES_PATH` environment variable (read with the `shell_exec` tool:
   `echo "$OSPREY_RULES_PATH"`).
3. Ask the operator via the `ask_user_question` tool.

After resolving, confirm the path contains `main.sml` (run
`test -f "$RULES_PATH/main.sml"` via `shell_exec`). If it does not, report the error
and stop.

## Resolve the skywatch-osprey repo path

`osprey-cli` is never installed globally. It lives inside the
`skywatch-osprey` repository and must be invoked via `uv run`. Resolve the
repo path:

1. `OSPREY_REPO_PATH` if set and it contains `osprey_worker/`
   (`test -d "$OSPREY_REPO_PATH/osprey_worker"`).
2. Otherwise walk up from the rules project path looking for a directory that
   contains `osprey_worker/`.
3. Otherwise ask the operator via the `ask_user_question` tool.

Persist the resolved repo path for the session.

## Run validation

From the osprey repo, capture both stdout and stderr:

```bash
cd "$OSPREY_REPO" && uv run osprey-cli push-rules "$RULES_PATH" --dry-run
```

## Report results

- Exit code 0 → "Validation successful; the Osprey rules project is valid."
- Exit code 1 → "Validation failed." Show the errors above, then offer to load
  the `skywatch-fixing-osprey-rules` skill for debugging assistance.
- Any other exit code → report the unexpected code and note that
  `uv run osprey-cli` should work from `$OSPREY_REPO`.

**Report the FULL osprey-cli output verbatim.** Do not summarise, truncate, or
omit any errors.