Create Agent Skills
Teams need consistent skill files that agents can discover and use correctly. This skill guides authors through structure, descriptions, examples, scripts, and review checks.
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Review the Skillstore skill "write-a-skill" from https://skillstore.io/skills/mattpocock-write-a-skill.md and its manifest at https://skillstore.io/api/skills/mattpocock-write-a-skill/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Your Agent should still show its plan and request any confirmation required by the security policy.
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Using "write-a-skill". Create a skill for reviewing API documentation.
Expected outcome:
A draft plan with required questions, a suggested SKILL.md outline, and review points for documentation accuracy.
Using "write-a-skill". Improve this vague skill description: Helps with docs.
Expected outcome:
A clearer description that names the task, trigger phrases, and expected document types.
Using "write-a-skill". Should this skill include scripts or reference files?
Expected outcome:
A recommendation based on deterministic work, file length, advanced material, and reuse value.
All seven static findings are Markdown code fences or examples in SKILL.md, not executable shell or Ruby calls. I found no prompt injection, data exfiltration, network access, or unsafe command execution intent in the reviewed file.
Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.
https://skillstore.io/skills/mattpocock-write-a-skill/audits/4?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report[](https://skillstore.io/skills/mattpocock-write-a-skill?utm_source=security_passport_badge)<a href="https://skillstore.io/skills/mattpocock-write-a-skill?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/mattpocock-write-a-skill/security.svg" alt="Skillstore security assessment" loading="lazy"></a><iframe src="https://skillstore.io/embed/skills/mattpocock-write-a-skill.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>mattpocock. (2026). write-a-skill security audit report (audit version 4) [Author version unspecified]. Skillstore. https://skillstore.io/skills/mattpocock-write-a-skill/audits/4@techreport{mattpocock-mattpocock-write-a-skill-2026,
author = {mattpocock},
title = {write-a-skill security audit report (audit version 4)},
institution = {Skillstore},
year = {2026},
number = {4},
url = {https://skillstore.io/skills/mattpocock-write-a-skill/audits/4},
note = {Author version unspecified}
}cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "write-a-skill security audit report (audit version 4)"
version: "unspecified"
type: report
authors:
- name: "mattpocock"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/mattpocock-write-a-skill/audits/4"
identifiers:
- type: other
value: "skillstore:mattpocock-write-a-skill:audit:4"
description: "Skillstore immutable audit report identifier"
A solo author can turn a task idea into a SKILL.md draft with clear triggers and sections.
A platform team can align skill descriptions, examples, and review criteria across a shared library.
A developer can decide when to add reference files or helper scripts for complex workflows.
Use write-a-skill to draft a SKILL.md for [task]. Ask me for missing requirements first.
Use write-a-skill to review this skill description for clear triggers, scope, and user intent: [paste description].
Use write-a-skill to decide which reference files, examples, or helper scripts this skill needs: [domain and use cases].
Use write-a-skill to audit this draft against the review checklist and recommend precise edits: [paste draft].
Author
mattpocockLicense
MIT
Skillstore revision
r1
Version notice
The author did not declare a version.
Ref
b8ca75d2c0a7e7102978993058777d82b8ab2610
Maintenance freshness
7/18/2026
Usage
9 downloads · 88 views
File structure
📄 SKILL.md
Guide TDD with Red-Green-Refactor
Test-first work often becomes brittle when teams test internals or write too many tests upfront. This skill guides Codex, Claude, and Claude Code through behavior-focused red-green-refactor cycles.
Sharpen Plans and Create Decision Documentation
Unresolved assumptions weaken plans and technical designs. This skill conducts a focused interview and uses domain modeling to produce ADRs and a glossary.
Stress-Test Your Plan Before Building
Unresolved decisions can make a plan expensive to change during implementation. This skill interviews you systematically and recommends an answer for each decision.
Build Focused Logic and UI Prototypes
Design decisions are difficult to evaluate before users can interact with them. This skill builds disposable prototypes that expose state behavior or compare interface variants.
Pressure-test plans with grilling interviews
Plans and designs often fail because weak assumptions are found too late. This skill starts a focused grilling session that challenges gaps before execution begins.
Build Articles One Grounded Beat at a Time
Unstructured notes make it difficult to create a clear article without losing the reader. This skill builds a user-directed sequence that introduces concepts before using them.
Organize Long AI Tasks with Planning Files
by ZhanlinCui
Long AI sessions can lose goals, decisions, and progress. This skill guides Claude, Codex, and Claude Code to store plans, findings, and logs in project files.
Create CCGG Project Workspaces
by DaronVee
Project setup often misses shared operations, index, and logging requirements. This skill guides Claude, Codex, and Claude Code through structured CCGG project creation with templates and validation checks.
Create and Share Team Skills
by 89jobrien
Teams need a consistent way to create and distribute reusable AI skills. This skill guides creation, validation, packaging, and Slack sharing for faster discovery.
Plan Software Projects With Structured Documents
by Dwsy
Software projects often fail when requirements, design choices, and tasks are unclear. This skill turns project ideas into structured planning documents for Claude, Codex, and Claude Code workflows.
Generate Bilingual GitHub Release READMEs
by ZhanlinCui
Release notes and README updates can take time before each GitHub release. This skill generates bilingual release documentation and guides review, commit, and push steps.
Create Effective AI Skills
by 89jobrien
Building reusable AI skills is hard when structure, resources, and validation rules are unclear. This skill provides a practical workflow for designing, writing, validating, and packaging skills.