agentsclimarketplace
Sign in

Skill authoring

Skill pockebot/openpocket/skills/skill-authoring

Refine draft skills into strict, reusable SKILL.md documents with stable triggers, preconditions, and failure branches.From its SKILL.md

Install
npx -y skills add pockebot/openpocket --skill skill-authoring

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

1.4 KB, as published. Nobody here has run it

skill-authoring

Use this skill when converting a rough draft into a production-ready skill document.

Goal

Transform noisy step traces or draft markdown into a strict SKILL.md that is:

  1. deterministic to execute
  2. explicit about when to trigger
  3. explicit about failure handling
  4. valid against strict skill validation rules

Required Structure

  1. Frontmatter:
    • name (kebab-case, matches directory)
    • description (one concise sentence)
    • optional metadata JSON for triggers/requirements
  2. Body sections:
    • When To Use
    • Preconditions
    • Procedure
    • Failure Handling
    • Completion Criteria

Refinement Rules

  1. Replace fragile coordinates with semantic UI targets whenever possible.
  2. Keep each procedure step one atomic action.
  3. Add at least one fallback path for common blockers (auth wall, empty state, loading timeout).
  4. If personal data is required, add request_human_auth guidance before UI actions.
  5. Keep language concise and executable.

Validation Gate

Before promotion:

  1. Run strict skill validation.
  2. If validation fails, keep as draft and report issues.
  3. Promote only validated output.

Keep looking

Skills are one crate of 627,801. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.