skill builder

Engineering Community

Skill notes

When to Use

Use this skill when the user wants to: create a brand new skill turn a repeated prompt or workflow into a reusable skill improve an existing skill's structure, trigger description, or bundled resources add realistic eval prompts for a skill

Decide First: Skill or Tool?

Choose a skill when the capability is mostly instructions, shell commands, and existing tools. Choose a tool instead when the task needs: strict runtime behavior every time built-in auth or API-key handling binary or streaming data handling

Clarify the Contract

If important details are missing, ask only for the smallest set of answers needed: Skill name: must be kebab-case Capability: what the skill should help the agent do Triggering context: what kinds of user requests should activate it Outputs: what files or results the skill should produce

Directory Layout

Use this layout unless the task clearly needs less:

Scope Rules

Each skill must live in its own directory, and the directory name must exactly match the skill name in kebab-case Prefer the user-global path: ~/.flocks/plugins/skills/<name>/SKILL.md Do not write user-created skills to .flocks/skills/; that location is for built-in skills, not user/project-authored plugin skills Do not scatter skill files into docs/, tests/, or ad hoc output folders

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Engineering
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@AgentFlocks · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Required · Vendor-specific
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
Python
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
  • Env read
Network behavior
External requests
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview skill-builder-agentflocks.preview
# 2. Inspect Nearby Examples

- frontmatter tone
- section naming
- path conventions
- validation style

Discussion

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