Create Skill
SkillFiles & storageCreate or update AI agent skills (SKILL.md + reference files) for any harness that supports the format: GitHub Copilot, Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Kiro, OpenCode, and more. Use when: authoring a new skill from scratch, improving or restructuring an existing skill, deciding how to split content across files, writing skill frontmatter, choosing trigger phrases for the description field, organizing reference files. Covers skill architecture, compact writing rules, frontmatter constraints, and research workflow via context7/microsoftdocs MCPs. DO NOT USE FOR: general coding tasks, VS Code extension development, non-skill documentation.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Create Skill skill
What this skill tells your AI
The instructions your AI receives, as published by netfabric/netfabric.numerics in .agents/skills/create-skill/SKILL.md and read by ahel’s review.
Skills built this way run in any harness that supports SKILL.md — Copilot, Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Kiro, OpenCode, and more — not just one tool.
Anatomy
A skill is a folder (<skill-name>/, kebab-case) containing:
| File | Purpose | Target Size |
|---|---|---|
SKILL.md | Entry point — facts, quick-ref, reference table | <100 lines |
references/*.md | Deep detail, examples, edge cases | <200 lines each |
scripts/ | Runnable helpers invoked by skill instructions | — |
assets/ | Templates, data files, images referenced by skill | — |
SKILL.md Frontmatter
---
name: <skill-name> # matches folder name
description: "<≤1024 chars>" # double-quoted; trigger phrases; relevance context; exclusions
---
Description rules: always wrap the value in double quotes — descriptions routinely contain colons ("USE FOR:", "DO NOT USE FOR:") that break strict YAML parsers when left unquoted; keyword-rich; list trigger phrases; state exclusions with "DO NOT USE FOR:"; ≤1024 chars; never write a literal # preceded by whitespace — YAML treats it as a comment and silently truncates the rest of the value (reword instead, e.g. "colon-prefixed directives" not "#:"). Full rules → references/structure.md.
Workflow: New Skill
- Define scope — subject, users, trigger phrases, exclusions
- Research — load references/research-workflow.md
- Draft SKILL.md skeleton (tables, code blocks, ref table)
- Extract detail → reference files
- Validate frontmatter length (
echo -n "..." | wc -c) - Run
markdown-best-practicesover every new/edited.mdfile — heading spacing, table/list consistency, fenced-code language tags
Workflow: Update Skill
- Re-fetch affected docs via context7 / microsoftdocs
- Edit only the reference file(s) that changed
- Update SKILL.md summary + reference table if needed
- Verify description ≤1024 chars
- Re-run
markdown-best-practicesover every file touched
Writing Rules (summary)
- Tables > prose; omit preamble; active voice
- Comments only when code can't show intent
- No restatements, no obvious callouts
- Full rules → references/writing-style.md
Reference Files
| File | Load When |
|---|---|
| references/structure.md | Designing folder layout, frontmatter, or reference conventions |
| references/writing-style.md | Writing or reviewing content for token efficiency |
| references/research-workflow.md | Researching a new or updated skill topic |
Signals
- GitHub stars
- 36
- Forks
- 1
- Last commit
- Aug 2026
Advanced
- Catalog kind
- skill
- Gateway key
create-skill-netfabric- Source
- github.com/netfabric/netfabric.numerics