planning-osprey-rules

Validate investigator reports and produce structured Osprey SML rule specifications.

6|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/skywatch-bsky/skywatch-agent-skills --skill planning-osprey-rules
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: planning-osprey-rules
Source: https://github.com/skywatch-bsky/skywatch-agent-skills/tree/main/claude-skills/plugins/osprey-rules/skills/planning-osprey-rules
Command: npx skills add https://github.com/skywatch-bsky/skywatch-agent-skills --skill planning-osprey-rules

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents downstream implementation failures by enforcing a rigorous, structured requirements-gathering phase before any SML code is written for Osprey rules.

Core Features & Use Cases

  • Context Validation: Ensures the investigator report contains all necessary project metadata, labels, and UDF signatures before proceeding.
  • Requirement Specification: Guides the user through defining event types, signals, target entities, and expiration logic in a standardized format.
  • Use Case: When tasked with creating a new detection rule for profanity, this skill ensures the label exists in the configuration and that the target entity (post vs. account) is correctly identified, preventing invalid code generation.

Quick Start

Initiate the planning-osprey-rules skill to begin gathering requirements for a new rule based on the provided investigator report.

Frequently Asked Questions about planning-osprey-rules

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

FAQPage Schema
How do I gather requirements for SML rules in Osprey?

To gather requirements for SML rules in Osprey, standardize the planning phase by validating project context and producing structured specifications. This process defines detection logic, labeling patterns, and entity types before writing code.

Why does Osprey rule creation fail without structured requirements gathering?

Osprey rule creation fails without structured requirements gathering because it leads to invalid code generation. Enforcing a rigorous planning phase ensures labels exist in configurations and target entities are correctly identified, preventing downstream implementation failures.

What do I need to provide before gathering requirements for an Osprey SML rule?

Before gathering requirements for an Osprey SML rule, you need a valid investigator report. This report must contain project structure, label tables, and UDF signatures to successfully validate project context and proceed with specification generation.

How does context validation work when defining ATProto rule specifications?

Context validation for ATProto rule specifications works by checking the investigator report for necessary project metadata, labels, and UDF signatures. This ensures all required configuration details are present before defining event types and target entities.

Can I define target entities and expiration logic without a label table in the investigator report?

No, you cannot define target entities and expiration logic without a label table in the investigator report. The skill requires a valid investigator report containing project structure, label tables, and UDF signatures to function and produce specifications.