Skill Master

Overview

Analyze codebase to discover patterns and generate/update SKILL files in .claude/skills/. Supports multi-platform projects with stack-specific pattern detection.

Capabilities:

• •Scan codebase for architectural patterns (ViewModel, Repository, Room, etc.)
• •Compare detected patterns with existing skills
• •Auto-generate SKILL files with real code examples
• •Version tracking and smart updates

How the AI discovers and uses this skill

This skill triggers when user:

• •Asks to analyze project for missing skills
• •Requests skill generation from codebase patterns
• •Wants to sync or update existing skills
• •Mentions "skill discovery", "generate skills", or "skill-sync"

Detection signals:

• •.claude/skills/ directory presence
• •Project structure matching known patterns
• •Build/config files indicating platform (see references)

Modes

Discover Mode

Analyze codebase and report missing skills.

Steps:

1. •Detect platform via build/config files (see references)
2. •Scan source roots for pattern indicators
3. •Compare detected patterns with existing .claude/skills/
4. •Output gap analysis report

Output format:

Detected Patterns: {count}
| Pattern | Files Found | Example Location |
|---------|-------------|------------------|
| {name}  | {count}     | {path}           |

Existing Skills: {count}
Missing Skills: {count}
- {skill-name}: {pattern}, {file-count} files found

Generate Mode

Create SKILL files from detected patterns.

Steps:

1. •Run discovery to identify missing skills
2. •For each missing skill:
   • •Find 2-3 representative source files
   • •Extract: imports, annotations, class structure, conventions
   • •Extract rules from .ruler/*.md if present
3. •Generate SKILL.md using template structure
4. •Add version and source marker

Generated SKILL structure:

---
name: {pattern-name}
description: {Generated description with trigger keywords}
version: 1.0.0
---

# {Title}

## Overview
{Brief description from pattern analysis}

## File Structure
{Extracted from codebase}

## Implementation Pattern
{Real code examples - anonymized}

## Rules
### Do
{From .ruler/*.md + codebase conventions}

### Don't
{Anti-patterns found}

## File Location
{Actual paths from codebase}

Create Strategy

When target SKILL file does not exist:

1. •Generate new file using template
2. •Set version: 1.0.0 in frontmatter
3. •Include all mandatory sections
4. •Add source marker at end (see Marker Format)

Update Strategy

Marker check: Look for <!-- Generated by skill-master command at file end.

If marker present (subsequent run):

• •Smart merge: preserve custom content, add missing sections
• •Increment version: major (breaking) / minor (feature) / patch (fix)
• •Update source list in marker

If marker absent (first run on existing file):

• •Backup: SKILL.md → SKILL.md.bak
• •Use backup as source, extract relevant content
• •Generate fresh file with marker
• •Set version: 1.0.0

Marker Format

Place at END of generated SKILL.md:

<!-- Generated by skill-master command
Version: {version}
Sources:
- path/to/source1.kt
- path/to/source2.md
- .ruler/rule-file.md
Last updated: {YYYY-MM-DD}
-->

Platform References

Read relevant reference when platform detected:

If multiple platforms detected, read multiple references.

Rules

Do

• •Only extract patterns verified in codebase
• •Use real code examples (anonymize business logic)
• •Include trigger keywords in description
• •Keep SKILL.md under 500 lines
• •Reference external files for detailed content
• •Preserve custom sections during updates
• •Always backup before first modification

Don't

• •Include secrets, tokens, or credentials
• •Include business-specific logic details
• •Generate placeholders without real content
• •Overwrite user customizations without backup
• •Create deep reference chains (max 1 level)
• •Write outside .claude/skills/

Content Extraction Rules

From codebase:

• •Extract: class structures, annotations, import patterns, file locations, naming conventions
• •Never: hardcoded values, secrets, API keys, PII

From .ruler/*.md (if present):

• •Extract: Do/Don't rules, architecture constraints, dependency rules

Output Report

After generation, print:

SKILL GENERATION REPORT

Skills Generated: {count}

{skill-name} [CREATED | UPDATED | BACKED_UP+CREATED]
├── Analyzed: {file-count} source files
├── Sources: {list of source files}
├── Rules from: {.ruler files if any}
└── Output: .claude/skills/{skill-name}/SKILL.md ({line-count} lines)

Validation:
✓ YAML frontmatter valid
✓ Description includes trigger keywords
✓ Content under 500 lines
✓ Has required sections

Safety Constraints

• •Never write outside .claude/skills/
• •Never delete content without backup
• •Always backup before first-time modification
• •Preserve user customizations
• •Deterministic: same input → same output