skills.rest
pwv-vc
pwv-vcOFFICIAL
Explore all skills by this author →
Website𝕏@pwventuresGitHub

skill-writer

Document and enforce the arsenal-first workflow for creating and editing Claude Code skills.

6|1|Updated Mar 5, 2026
Search Tags:#git#workflow#documentation#claude#skill-writer#arsenal#install.sh
One-click install
npx skills add https://github.com/pwv-vc/agentcribs-community --skill skill-writer-pwv-vc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/pwv-vc/agentcribs-community/tree/main/resources/tearsheets/arsenal/dot-claude/skills/skill-writer
Command: npx skills add https://github.com/pwv-vc/agentcribs-community --skill skill-writer-pwv-vc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill explains and enforces the arsenal-first workflow for Claude Code skill creation and maintenance, ensuring changes are made in the source of truth and synced via install.sh.

Core Features & Use Cases

  • Clear frontmatter and metadata requirements, including name and description
  • Arsenal as the source of truth; .claude/ is a generated copy
  • Step-by-step workflow: edit Arsenal, run install.sh, test, and commit only arsenal
  • Update CLAUDE.md registry to reflect new skills and changes

Quick Start

Read the skill-writer SKILL.md in arsenal/dot-claude/skills/skill-writer to understand the workflow, then run the arsenal install script to sync changes to .claude/ and verify compliance.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I create a new Claude Code skill using the arsenal-first workflow?▼

To create a Claude Code skill, you edit SKILL.md with YAML frontmatter in the arsenal directory, run install.sh to sync changes to .claude, test the skill, and commit only the arsenal repository.

What is the arsenal-first workflow for managing Claude Code skills?▼

The arsenal-first workflow keeps arsenal/dot-claude as the source of truth for skill creation, ensuring you edit files there and use install.sh to propagate generated copies to the .claude directory.

Do I need YAML frontmatter in SKILL.md files for Claude Code skills?▼

Yes, YAML frontmatter with name and description fields is required in SKILL.md files to enforce the arsenal-first workflow and maintain proper skill metadata documentation.

Why does editing .claude directly cause sync issues with the arsenal repository?▼

Editing .claude directly causes sync issues because .claude is a generated copy; the arsenal directory is the source of truth, and install.sh must propagate changes to prevent overwriting manual edits.

Can I use git to commit both arsenal and .claude directories after updating skills?▼

No, you should only commit the arsenal repository after running install.sh; the .claude directory is a generated output and should not be committed to git alongside arsenal changes.

What's the best way to update the CLAUDE.md registry when adding new skills?▼

Update the CLAUDE.md registry to reflect new skills and changes by editing it within the arsenal directory, then run install.sh to sync the updated registry to .claude and verify compliance.

Related Skills

Explore More Software Engineering Skills→
m-bradym-brady

skill-creator

Enforce test-driven development for creating and editing Claude Code skills.

Community
Basic
pwv-vcpwv-vc
6

skill-docs-updater

Regenerate SKILLS-INDEX.md from YAML frontmatter in SKILL.md files.

Official
Intermediate
miko06miko06

document-release

Update project documentation files after shipping using Git and Bash.

Community
Advanced
bolun-ben-shipbolun-ben-ship

update-everywhere

Detect git session changes and generate a propagation plan for workspace references.

Community
Advanced