skill-writer

Create or update agent skills following the Agent Skills specification workflow.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/baselakkad585-maker/basel-dev-skills --skill skill-writer-baselakkad585-maker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/baselakkad585-maker/basel-dev-skills/tree/main/skills/skill-writer
Command: npx skills add https://github.com/baselakkad585-maker/basel-dev-skills --skill skill-writer-baselakkad585-maker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill Writer provides a canonical workflow to create and improve agent skills in alignment with the Agent Skills specification.

Core Features & Use Cases

  • Canonical, repeatable workflow for skill creation and updates.
  • Loads and leverages guidance from references, examples, patterns, and design principles to reduce blind spots.
  • Supports structured authoring, evaluation, and registration to ensure consistent quality and governance.

Quick Start

Follow the Skill Writer workflow to create or update a skill, starting from resolving the target path and proceeding through authoring, optimization, and validation.

Frequently Asked Questions about skill-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create agent skills that pass validation checks?

To create agent skills that pass validation, follow a canonical workflow enforcing mandatory frontmatter, loading reference guidance, and validating outputs against depth gates and artifact checks.

What is the best way to structure agent skill authoring workflows?

The best way to structure agent skill authoring workflows is by applying a repeatable process covering resolution, authoring, optimization, and registration to ensure consistent quality.

Do I need frontmatter when authoring agent skills?

Yes, you need mandatory frontmatter specifying the skill name and description when authoring agent skills, as this is strictly enforced during the output validation process.

How does the agent skill creation process use references and patterns?

The agent skill creation process loads guidance from references, examples, and patterns to reduce blind spots and ensure the skill aligns with the specification.

Can I update existing agent skills without breaking their specification compliance?

Yes, you can update existing agent skills safely by applying the canonical workflow to iteration and evaluation tasks, validating the updated outputs against depth gates and artifact checks.

When should I use a structured workflow for agent skill development?

You should use a structured workflow for agent skill development when you need consistent quality, governance, and reduced blind spots across multiple authoring or registration tasks.