ssl-skill-normalizer

Solid

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

Data & Documents 4,550 stars 412 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

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Solid

skill-standardization

Standardize and validate SKILL.md files against the Agent Skills specification (agentskills.io). Use when creating new skills, auditing existing skills for spec compliance, converting legacy skill formats to standard structure, or improving descriptions for reliable triggering. Triggers on: "validate skill", "create SKILL.md", "standardize skill format", "check skill spec", "skill frontmatter", "improve skill description", "add evals to skill".

335 Updated today
aiskillstore
AI & Automation Solid

oma-skill-creator

Create or update OMA skills in the SSL-lite human-readable format. Use when adding a new `.agents/skills/{skill-name}/SKILL.md`, converting an existing skill to the standardized Scheduling / Structural Flow / Logical Operations / References structure, or validating whether a skill has enough routing, execution, resource, and safety detail.

1,042 Updated today
first-fluke
Data & Documents Listed

skill-development

This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.

11 Updated today
jessevanwyk1
Data & Documents Listed

skill-creator

Authors and structures professional-grade agent skills following the agentskills.io spec. Use when creating new skill directories, drafting procedural instructions, or optimizing metadata for discoverability. Don't use for general documentation, non-agentic library code, or README files.

1 Updated today
riqxa
AI & Automation Solid

skill-development

This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.

29,021 Updated today
anthropics