gandalf-the-greybeard[bot]
a5ffe58735
Add .markdownlint-cli2.jsonc to suppress MD013 (line-length) and MD041 (first-line-heading) which are inappropriate for agent skill files with YAML frontmatter and code examples. Fix genuine structural issues in all affected files: - Add blank lines around headings (MD022) - Add blank lines around fenced code blocks (MD031) - Add blank lines around lists (MD032) - Add language specifiers to bare code fences (MD040) Resolves: PRI-93 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
26 lines
865 B
Markdown
26 lines
865 B
Markdown
# Headlamp Agent Skills
|
|
|
|
This repository is the home for developing and maintaining Claude Code agent skills for Headlamp Kubernetes dashboard plugin development.
|
|
|
|
## Repository Structure
|
|
|
|
```text
|
|
.claude/agents/ # Agent skill definitions (markdown with YAML frontmatter)
|
|
README.md # Project documentation
|
|
```
|
|
|
|
## Agent Skill Format
|
|
|
|
Each skill is a markdown file in `.claude/agents/` with:
|
|
|
|
1. **YAML frontmatter** — `name`, `description`, `tools`, `model`
|
|
2. **System prompt** — Role and behavioral instructions
|
|
3. **Reference sections** — API docs, patterns, conventions, and code examples
|
|
|
|
## Guidelines
|
|
|
|
- Keep skills focused and practical — include API signatures, code patterns, and common pitfalls
|
|
- Use code blocks for all API examples
|
|
- Include test mock patterns where applicable
|
|
- Update skills when Headlamp APIs change
|