osprey-sml-reference

Document Osprey SML rule syntax and best practices for moderation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a comprehensive reference for writing SML rules in Osprey, helping developers avoid common syntax errors, type system pitfalls, and inefficient logic patterns when building moderation workflows.

Core Features & Use Cases

  • Rule Syntax & Type System: Provides clear guidance on using EntityJson, JsonData, and proper type handling to ensure labels attach correctly to entities.
  • Pattern Library: Includes 25 proven labeling patterns, ranging from simple content matching and sliding window rate limiting to complex strike systems and ML-scored labeling.
  • Convention Enforcement: Offers a structured reviewer checklist to ensure all rules follow naming, time constant, and structural best practices for maintainability.

Quick Start

Consult the osprey-sml-reference skill to verify the correct syntax for implementing a sliding window rate limit rule.

Frequently Asked Questions about osprey-sml-reference

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

FAQPage Schema
How do I write moderation rules in Osprey SML for event extraction and label application?

Osprey SML moderation rules define logic for event extraction and label application by using proper type handling for EntityJson and JsonData. This ensures labels attach correctly to entities within the moderation framework.

What is the best way to implement sliding window rate limiting using Osprey SML?

Sliding window rate limiting in Osprey SML is implemented using proven labeling patterns from the provided pattern library. This reference includes 25 patterns ranging from simple content matching to complex strike systems.

How does type safety work when attaching labels to entities in Osprey SML?

Type safety in Osprey SML relies on correctly handling EntityJson and JsonData structures. Proper type system usage prevents common syntax errors and ensures labels attach to the correct entities.

What naming and structural conventions should Osprey SML rules follow for maintainability?

Osprey SML rules should follow structured naming conventions, time constant standards, and structural best practices. A reviewer checklist is provided to enforce these conventions for maintainable moderation workflows.

Can I use UDFs efficiently within Osprey moderation framework rules?

UDFs can be used efficiently within the Osprey moderation framework by following best practices for rule logic construction. This reference provides guidance to avoid inefficient logic patterns when building workflows.

Why are my Osprey SML moderation rules failing to apply labels correctly?

Osprey SML rules fail to apply labels when EntityJson and JsonData types are mishandled. This reference helps developers avoid common type system pitfalls and syntax errors during rule construction.