ssl-skill-normalizer

Featured

Normalize SKILL.md artifacts into Scheduling-Structural-Logical (SSL) JSON representations using a conservative multi-pass extraction pipeline.

Data & Documents 4,523 stars 402 forks Updated today MIT

Install

View on GitHub

Quality Score: 97/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# SSL Skill Normalizer ## Purpose This skill converts markdown-based skill artifacts into a structured **Scheduling-Structural-Logical (SSL)** representation as introduced in: > Liang et al., "From Skill Text to Skill Structure: The Scheduling-Structural-Logical Representation for Agent Skills", arXiv:2604.24026 (2026). SSL addresses the core limitation of free-form skill text: it is human-readable but hard for agents to reason over, discover, and audit. By mapping each skill into three complementary layers, SSL makes skills **searchable** (improved MRR 0.573 → 0.707 in the paper) and **risk-assessable** (improved macro F1 0.744 → 0.787). --- # The Three SSL Layers The representation is grounded in Schank & Abelson's theories of Memory Organization Packets (MOPs), Script Theory, and Conceptual Dependency. Each layer captures a different dimension of skill knowledge: ## Layer 1 — Scheduling (When / Who) Answers: *When should this skill be invoked? By whom, given which inputs and outputs?* Fields extracted: - `id` — stable lowercase identifier - `name` — human-readable skill name - `goal` — one-sentence purpose - `intent_signature` — typed function signature (`fn($input) -> $output`) - `inputs` — `$`-prefixed named input bindings - `outputs` — `$`-prefixed named output bindings - `dependencies` — explicit runtime tool or library requirements - `control_flow_features` — e.g. `sequential`, `conditional`, `loop` - `entry_scene` — ID of the first scene to execute - `subsc...

Details

Author
github
Repository
github/gh-aw
Created
9 months ago
Last Updated
today
Language
Go
License
MIT

Related Skills

Data & Documents Featured

clinical-decision-support

Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug development, clinical research, and evidence synthesis.

25,858 Updated today
K-Dense-AI
Data & Documents Featured

seo-dataforseo

Live SEO data via DataForSEO MCP server. SERP analysis (Google, Bing, Yahoo, YouTube, Google Images), keyword research (volume, difficulty, intent, trends), backlink profiles, on-page analysis (Lighthouse, content parsing), competitor analysis, content analysis, business listings, AI visibility (ChatGPT scraper, LLM mention tracking), and domain analytics. Requires DataForSEO extension installed. Use when user says "dataforseo", "live SERP", "keyword volume", "backlink data", "competitor data", "AI visibility check", "LLM mentions", "image SERP", "google images", "image rankings", or "real search data".

7,082 Updated today
AgriciDaniel
Data & Documents Featured

alphasense

AlphaSense integration. Manage data, records, and automate workflows. Use when the user wants to interact with AlphaSense data.

3,964 Updated 1 months ago
openclaw