Skip to content

Add Claude Code skills for profile and fleet generation#15

Merged
tallpsmith merged 3 commits into
feature/fleet-modefrom
feature/claude-skills
Mar 20, 2026
Merged

Add Claude Code skills for profile and fleet generation#15
tallpsmith merged 3 commits into
feature/fleet-modefrom
feature/claude-skills

Conversation

@tallpsmith
Copy link
Copy Markdown
Owner

@tallpsmith tallpsmith commented Mar 20, 2026

Summary

  • Replace old /generate-profile slash command with a proper SKILL.md skill that bundles the full profile schema as reference context
  • Add new generate-fleet-profile skill for natural-language generation of multi-host fleet profiles with bad actors, jitter, and workload references
  • Update README Quick Start section 6 to document both skills with example prompts

What changed

  • Removed: .claude/commands/generate-profile.md (old slash-command format)
  • Added: .claude/skills/generate-profile/ — single-host workload profile generation with bundled schema reference
  • Added: .claude/skills/generate-fleet-profile/ — fleet profile generation with fleet schema + workload schema references
  • Updated: README.md section 6 — documents both skills with example natural-language prompts

Eval results

Both skills were tested against 3 scenarios each (with-skill vs without-skill baseline):

Skill Assertions Pass Rate Avg Speedup
generate-profile 25 96% (24/25) 1.4x
generate-fleet-profile 24 100% (24/24) 1.9x

The fleet skill shows the biggest advantage on complex scenarios (2.2x faster for a 50-host cluster) because it saves agents from reverse-engineering the fleet format from source code.

Test plan

  • ./pre-commit.sh passes (503 unit/integration + 7 E2E tests)
  • Both skills produce valid YAML that passes pmlogsynth --validate
  • Fleet skill produces valid fleet profiles that pass pmlogsynth fleet --validate
  • Manual: invoke generate-profile skill with a natural-language prompt
  • Manual: invoke generate-fleet-profile skill with a fleet description

🤖 Generated with Claude Code

Replace old /generate-profile slash command with proper SKILL.md skills
that bundle the full schema as reference context. New fleet skill enables
natural-language generation of multi-host fleet profiles with bad actors.
Both skills now run `uv sync` + `uv run pmlogsynth` to validate AND
generate the actual PCP archives. Shared bootstrap reference extracted
to references/running-pmlogsynth.md for both skills.
@tallpsmith tallpsmith force-pushed the feature/claude-skills branch from 42805f0 to 5b0b091 Compare March 20, 2026 23:03
@tallpsmith tallpsmith merged commit c4bef3e into feature/fleet-mode Mar 20, 2026
2 checks passed
@tallpsmith tallpsmith deleted the feature/claude-skills branch March 20, 2026 23:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant