structured-skill-creator

Create or update skills under `skills/` with strict compliance to the local structured template and validation workflow.

5 stars

Best use case

structured-skill-creator is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Create or update skills under `skills/` with strict compliance to the local structured template and validation workflow.

Teams using structured-skill-creator should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/structured-skill-creator/SKILL.md --create-dirs "https://raw.githubusercontent.com/GuicedEE/ai-rules/main/skills/.curated/structured-skill-creator/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/structured-skill-creator/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How structured-skill-creator Compares

Feature / Agentstructured-skill-creatorStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Create or update skills under `skills/` with strict compliance to the local structured template and validation workflow.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Structured Skill Creator

## Overview

Use this skill when the user asks to create or update a skill in the repository `skills/` directory and requires strict structure compliance.

This skill enforces:
- Local template-based scaffolding.
- `agents/openai.yaml` metadata alignment.
- Consistent directory and file layout.
- Required validation before delivery.

## Source of truth

- `scripts/create_skill_from_template.sh`
- `scripts/validate_skill_structure.sh`
- `references/skill-compliance-checklist.md`

## Quick start

1. Scaffold a new skill from the template:
   - `bash scripts/create_skill_from_template.sh <skill-name>`
2. Edit content for the requested domain/workflow:
   - `SKILL.md`
   - `references/` and `scripts/` as needed
3. Validate strict compliance:
   - `bash scripts/validate_skill_structure.sh <skill-dir>`
4. Re-run the validator before finalizing after each structural edit.

## Workflow

### 1) Gather required inputs

- Skill name (hyphen-case target name).
- Trigger conditions (when the skill should activate).
- Expected resources (`scripts`, `references`, `assets`).
- Interface metadata (`display_name`, `short_description`, `default_prompt`).

### 2) Scaffold from local template

- Use `scripts/create_skill_from_template.sh` to generate the skill skeleton.
- Add `LICENSE.txt` from the repository root license when available.
- Keep the initial skeleton minimal, then add only task-relevant content.

### 3) Implement skill content

- Keep `SKILL.md` concise and procedural.
- Put detailed domain material in `references/`.
- Put deterministic helpers in `scripts/`.
- Put output resources in `assets/` only when needed.

### 4) Enforce structural compliance

- Run `scripts/validate_skill_structure.sh` on the target skill.
- Reject non-template files in the skill root.
- Ensure `agents/openai.yaml` includes:
  - `interface.display_name`
  - `interface.short_description`
  - `interface.default_prompt` (must mention `$<skill-name>`)

### 5) Final verification

- Run `scripts/validate_skill_structure.sh`.
- Confirm no disallowed files were introduced.
- Confirm examples and references are relative and resolve inside the repository.

## Compliance requirements

- Skill name must be lowercase hyphen-case.
- Frontmatter requires `name` and `description`.
- Root skill files should match template conventions:
  - Required: `SKILL.md`, `agents/openai.yaml`, `LICENSE.txt`
  - Optional: `scripts/`, `references/`, `assets/`
- Do not add extraneous docs such as:
  - `README.md`
  - `INSTALLATION_GUIDE.md`
  - `QUICK_REFERENCE.md`
  - `CHANGELOG.md`

## References

- `references/skill-compliance-checklist.md`

Related Skills

skill-creator

5
from GuicedEE/ai-rules

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Codex's capabilities with specialized knowledge, workflows, or tool integrations.

guicedee-creator

5
from GuicedEE/ai-rules

Create new GuicedEE-ready Maven modules with enforced Maven 4 and JDK 25+ baselines, GuicedEE BOM import, and JPMS main/test module boundaries. Use when scaffolding a new module, generating initial `pom.xml` and `module-info.java` files, or validating that module/test packages are separated (`.test` suffix in tests).

skill-installer

5
from GuicedEE/ai-rules

Install Codex skills into $CODEX_HOME/skills from a curated list or a GitHub repo path. Use when a user asks to list installable skills, install a curated skill, or install a skill from another repo (including private repos).

jwebmp-webawesome

5
from GuicedEE/ai-rules

WebAwesome icon integration for JWebMP — modern, open-source icon library. Provides 1,500+ icons with solid/regular styles, sizing, rotation, animation, and CSS utilities. Drop-in FontAwesome alternative with fresh designs. Use when working with WebAwesome icons, modern icon designs, or as FontAwesome alternative in JWebMP applications.

jwebmp-webawesome-pro

5
from GuicedEE/ai-rules

WebAwesome Pro integration for JWebMP with premium icons and features. Extends jwebmp-webawesome with additional styles, premium icons, and advanced features. Use when working with WebAwesome Pro icons or premium WebAwesome features in JWebMP applications.

jwebmp-weather-icons

5
from GuicedEE/ai-rules

Weather Icons font library for JWebMP providing weather icon fonts. Use when displaying weather-related icons.

jwebmp-waypoints

5
from GuicedEE/ai-rules

Waypoints jQuery plugin for JWebMP triggering functions when elements enter the viewport. Use when implementing scroll-based interactions and animations.

jwebmp-waves-effect

5
from GuicedEE/ai-rules

Waves material design ripple effect for JWebMP creating Material Design click ripples on elements. Use when adding Material Design interaction effects.

jwebmp-vertx

5
from GuicedEE/ai-rules

Portable connector between JWebMP and Vert.x 5 powered by GuicedEE. Provides automatic page routing, AJAX event pipeline, data component servlet, CSS endpoint, site-loader script, WebSocket broadcasting via event bus, user-agent detection, and call-scope integration. Use when working with JWebMP Vert.x integration, HTTP routing, AJAX handling, WebSocket communication, or building reactive web applications with JWebMP.

jwebmp-tsclient

5
from GuicedEE/ai-rules

TypeScript client generation for JWebMP plugins. Provides annotations and utilities for generating TypeScript interfaces, components, services, and modules from Java code. Supports @TsDependency, @TsDevDependency, @NgComponent, @NgDataService, @NgRestClient annotations. Use when creating JWebMP plugins that generate TypeScript code, defining npm dependencies, building Angular-integrated components, or generating typed Angular REST client services.

jwebmp-toastr

5
from GuicedEE/ai-rules

Toastr jQuery notification plugin integration for JWebMP displaying non-blocking toast notifications. Use when showing transient user notifications and alerts.

jwebmp-themify-icons

5
from GuicedEE/ai-rules

Themify Icons font library for JWebMP providing a comprehensive icon font collection. Use when adding Themify icons to projects.