skill authoring

Documentation Community v1.0.0

Skill notes

Core Principle

A skill's description triggers it; the body teaches it. The description tells the agent WHEN to use the skill. The content tells the agent HOW to execute it.

Frontmatter Fields

Field · Required · Constraints name · Yes · Lowercase alphanumeric + hyphens, 1–64 chars description · Yes · Must include "Use when..." clause; 1–1024 chars version · Yes · Semantic version (e.g. 1.0.0) triggers · Recommended · Natural-language phrases that activate the skill

Writing Effective Triggers

Triggers should be phrases users naturally type. Good triggers: "write tests first" "tdd" "test driven development"

Trigger Guidelines

Natural language — How would a human ask for this? Multiple variations — Different ways to say the same thing Specific enough — Don't trigger on too many queries Common terms — Use terms people actually use

Voice and Tone

Use second person, present tense, active voice: ✅ "Write the test first" ✅ "You are implementing TDD" ❌ "The developer should..." (passive) ❌ "It is recommended that..." (wordy)

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Documentation
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
98 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@rohitg00 · v1.0.0 · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
Local-only
Install commands
None (reference only)
Output preview skill-authoring-rohitg00.preview
# Code Examples

// BAD
const result = doTheThing(badInput);

// GOOD
const validated = validate(input);
const result = doTheThing(validated);

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.