/f5-skill

description: Manage F5 skills and capabilities
argument-hint: <list|load|create|run> [skill-name]

/f5-skill - Knowledge Skill Management

List, install, and create knowledge skills for specialized capabilities.

ARGUMENTS

The user's request is: $ARGUMENTS

PURPOSE

Skills are knowledge packages that enhance Claude's capabilities:

• Pre-built expertise in specific domains
• Reusable across projects
• Shareable with team members
• **Anthropic-aligned format** with progressive loading

SKILL TYPES

| Type | Description | Example | |------|-------------|---------| | `stacks` | Framework/stack expertise | nestjs, fastapi, react | | `core` | Framework-agnostic skills | tdd, security, api-design | | `domain` | Business domain knowledge | fintech, healthcare, agriculture |

SKILL STRUCTURE (Anthropic-Aligned Format)

skills/
├── stacks/                    # Stack-specific skills
│   └── nestjs/
│       ├── SKILL.md          # REQUIRED - Main entry with frontmatter triggers
│       ├── scripts/          # OPTIONAL - Executable automation
│       │   ├── scaffold.py   # Module scaffolding
│       │   ├── generate.py   # Component generation
│       │   └── test.py       # Test runner
│       ├── references/       # OPTIONAL - Detailed docs (on-demand)
│       │   ├── architecture.md
│       │   ├── security.md
│       │   ├── database.md
│       │   ├── testing.md
│       │   └── performance.md
│       └── assets/           # OPTIONAL - Templates, configs
│           └── templates/
├── core/                      # Framework-agnostic skills
│   ├── tdd/
│   │   └── SKILL.md
│   └── security/
│       └── SKILL.md
└── domains/                   # Domain-specific skills
    └── fintech/
        └── SKILL.md

SKILL.MD FORMAT (Critical for Triggering)

The SKILL.md frontmatter is the **trigger mechanism**. Claude reads the description to decide when to activate the skill.

---
name: nestjs
version: "2.0.0"
description: |
  NestJS TypeScript backend development with enterprise patterns...

  Use this skill when: (1) Project has @nestjs/core in package.json,
  (2) Creating modules, controllers, services, guards,
  (3) Implementing JWT authentication...

  Auto-detects: nest-cli.json, *.module.ts, *.controller.ts, @nestjs/* packages.

  NOT for: Pure Express.js without NestJS, frontend React/Vue code.
---

# NestJS Development Skill

## Quick Reference
[Essential commands and patterns]

## When to Load Additional Resources
- **Complex architecture**: Read `references/architecture.md`
- **Security setup**: Read `references/security.md`

## Core Patterns
[Code examples with explanations]

## Scripts Reference
| Script | Usage | Description |
|--------|-------|-------------|
| `scaffold.py` | `scaffold.py user --crud` | Create module |

PROGRESSIVE LOADING LEVELS

Level 1: Metadata (~100 tokens) - Always in Context

The frontmatter is always available for Claude to decide when to activate.

Level 2: SKILL.md Body (~2000-5000 tokens) - On Activation

When skill triggers, Claude loads the SKILL.md body with core patterns.

Level 3: References & Scripts (variable) - On Demand

When detailed info needed, Claude reads from references/ directory.

ACTIONS

List Installed Skills

/f5-skill

Output:
🎯 Installed Skills

PROJECT SKILLS (.claude/skills/):
  ✓ api-design         Technical    v1.0.0
  ✓ testing-strategy   Process      v1.2.0
  ✓ security-basics    Security     v1.0.0

GLOBAL SKILLS (~/.claude/skills/):
  ✓ code-review        Process      v2.0.0
  ✓ git-workflow       Process      v1.5.0

Total: 5 skills active

List Available Skills

/f5-skill list

Output:
📋 Available Skills

INSTALLED:
  ✓ api-design         Technical expertise for REST/GraphQL APIs
  ✓ testing-strategy   Comprehensive testing approaches
  ✓ security-basics    Essential security practices

AVAILABLE TO INSTALL:
  ○ performance-tuning Optimization techniques
  ○ database-design    Schema and query optimization
  ○ ci-cd-pipeline     Deployment automation
  ○ documentation      Technical writing best practices
  ○ accessibility      WCAG compliance guidance

Install with: /f5-skill install <name>

Show Skill Details

/f5-skill show api-design

Output:
🎯 Skill: api-design

Type: Technical
Version: 1.0.0
Author: F5 Framework

Description:
REST and GraphQL API design best practices including
endpoint naming, versioning, error handling, and documentation.

Provides:
• REST endpoint naming conventions
• HTTP status code usage
• Error response formatting
• Pagination patterns
• Versioning strategies
• OpenAPI documentation

Files:
  knowledge.md      - Core knowledge (2.5KB)
  patterns/         - 3 pattern files
  examples/         - 2 example files

Dependencies:
  - security-basics (recommended)

Usage:
  Claude automatically applies this knowledge when
  designing or reviewing API endpoints.

Install Skill

/f5-skill install performance-tuning

Output:
📥 Installing: performance-tuning

Downloading from F5 skill registry...
✓ Downloaded skill package
✓ Validated skill structure
✓ Installed to .claude/skills/performance-tuning/

Skill Contents:
  knowledge.md    - Performance optimization guide
  patterns/       - 5 optimization patterns
  checklists/     - Performance review checklist

✓ Skill installed successfully!

💡 Claude will now apply performance-tuning knowledge
   when relevant to your tasks.

Create Custom Skill

/f5-skill create my-api-standards

Output:
🆕 Creating skill: my-api-standards

Created directory structure:
  .claude/skills/my-api-standards/
  ├── skill.yaml      # Edit metadata
  ├── knowledge.md    # Add your knowledge
  └── patterns/       # Add code patterns

Next steps:
1. Edit skill.yaml with metadata
2. Add knowledge content to knowledge.md
3. Add patterns to patterns/ directory

Template created at:
  .claude/skills/my-api-standards/skill.yaml

Skill Template

# .claude/skills