CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-creator

Guide for creating effective skills. Use this skill when users need to create a new skill or reshape a draft skill package before hardening, benchmarking, or distribution.

66

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./Plugins/skill-factory/fixtures/budget-archive/2026-04-19/skills/scaffolding_templates/scaffolding_templates/skill-creator/SKILL.md
SKILL.md
Quality
Evals
Security

Skill Creator

Use this skill to create or restructure a skill package so it is ready for hardening.

When to use

  • New skill creation from user intent.
  • Major reshape of an existing draft skill.
  • Packaging alignment across SKILL.md, references/, scripts/, and agents/openai.yaml.

Do not use

  • Release-hardening/evals: route to [[skill-builder]].
  • Install/import flows: route to [[skill-installer]].

Core Philosophy

  • Start with a narrow, executable scope.
  • Keep routing intent explicit in SKILL.md.
  • Preserve required context by relocating detail to references/.

Core workflow

  1. Confirm goal, trigger phrases, and category.
  2. Define smallest viable package boundary.
  3. Create/update required files with canonical names.
  4. Move deep details to references and keep SKILL.md route-focused.
  5. Run baseline validation commands and report outcomes.

Required output contract

Provide:

  • schema_version
  • mode
  • skill_path
  • changed_files
  • context_routes
  • validation_evidence
  • risks

Progressive disclosure policy

Never drop required context; relocate depth into references/ with explicit signposts.

Read when:

  • drafting structure and routing text: foundations
  • creating reusable handoff payloads: handoff package template
  • shaping examples and edge handling: examples and gotchas

Anti-Patterns to Avoid

  • Building broad package scaffolds without a clear trigger surface.
  • Duplicating long policy text in SKILL.md instead of references.
  • Returning unvalidated scaffolds as production-ready outputs.

Constraints

  • Preserve user constraints exactly.
  • Use deterministic, reproducible edits.
  • Redact sensitive values in outputs.
Repository
jscraik/Agent-Skills
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.