Skip to content

README.skills.md

Latest commit

 

History

History
83 lines (62 loc) · 3.49 KB

README.skills.md

File metadata and controls

83 lines (62 loc) · 3.49 KB

🎯 Agent Skills

Agent Skills are self-contained folders with instructions and bundled resources that enhance AI capabilities for specialized NAV development tasks.

Based on the Agent Skills specification, each skill contains a SKILL.md file with detailed instructions that agents load on-demand.

Skills differ from other primitives by supporting bundled assets (scripts, code samples, reference data) that agents can utilize when performing specialized tasks.

How to Use Agent Skills

What's Included:

  • Each skill is a folder containing a SKILL.md instruction file
  • Skills may include helper scripts, code templates, or reference data
  • Skills follow the Agent Skills specification for maximum compatibility

When to Use:

  • Skills are ideal for complex, repeatable workflows that benefit from bundled resources
  • Use skills when you need code templates, helper utilities, or reference data alongside instructions
  • Skills provide progressive disclosure - loaded only when needed for specific tasks

Usage:

  • Browse the skills table below to find relevant capabilities
  • Copy the skill folder to your local skills directory (.github/skills/)
  • Reference skills in your prompts or let the agent discover them automatically

Available Skills

Name Description Bundled Assets Location
Coming Soon NAV-specific skills will be added here .github/skills/

Creating NAV Skills

When creating agent skills for NAV projects:

  1. Follow Specification: Adhere to the Agent Skills specification
  2. Bundle Resources: Include templates, scripts, and reference data
  3. NAV Context: Include NAV-specific patterns and configurations
  4. Self-Contained: Skills should be independent and reusable
  5. Progressive Disclosure: Load only when needed for specific tasks

Potential NAV Skills

Platform Skills

  • nais-deployment: NAIS manifest templates and deployment helpers
  • kafka-setup: Kafka topic configuration and Rapids & Rivers templates
  • auth-integration: Azure AD/TokenX/ID-porten configuration helpers

Frontend Skills

  • aksel-components: Aksel Design System component templates
  • nextjs-patterns: Next.js 16 App Router patterns and examples
  • responsive-design: Norwegian responsive design templates

Backend Skills

  • kotlin-ktor-app: Kotlin/Ktor application structure templates
  • database-migration: PostgreSQL migration patterns and helpers
  • api-patterns: REST API patterns with OpenAPI documentation

Observability Skills

  • prometheus-metrics: Metric instrumentation templates
  • logging-patterns: Structured logging with Grafana Loki
  • tracing-setup: OpenTelemetry tracing configuration

Skill Structure

.github/skills/
└── skill-name/
    ├── SKILL.md              # Main instruction file
    ├── templates/            # Code templates
    ├── scripts/              # Helper scripts
    ├── examples/             # Example implementations
    └── reference/            # Reference documentation

Best Practices

  • Keep skills focused on specific domains
  • Include practical examples from NAV projects
  • Provide clear usage instructions
  • Bundle only necessary resources
  • Test skills in various NAV contexts
  • Document dependencies and requirements