directory-based-skill

Directory-Based Skill with File References and Registration

A skill loaded from a directory structure with SKILL.md frontmatter, plus file-based and URL-based instruction sources.

Code

skills/
  coding-standards/
    SKILL.md           # Instructions with YAML frontmatter
    scripts/
      lint-check.sh    # Helper scripts referenced in instructions
    references/
      patterns.md      # Reference documentation appended to context
    assets/
      diagram.png      # Visual assets

## <!-- skills/coding-standards/SKILL.md -->

name: coding-standards
description: Project coding standards and patterns
tags: [standards, conventions, quality]
parameters:

- name: language
  description: Target programming language
  type: string
  default: typescript
  examples:
- scenario: Apply coding standards to a new module
  expected-outcome: Code follows all project conventions

---

# Coding Standards

Follow these standards when writing code for this project...

// src/skills/load-skills.ts
import { skill, skillDir } from '@frontmcp/sdk';

// Load a directory-based skill with bundled scripts, references, and assets
const CodingStandards = await skillDir('./skills/coding-standards');

// File-based instructions -- path resolves relative to this file's directory
const DeployGuide = skill({
  name: 'deploy-guide',
  description: 'Step-by-step deployment checklist',
  instructions: { file: './docs/deploy-guide.md' }, // resolves to src/skills/docs/deploy-guide.md
});

// src/server.ts
import { App, FrontMcp, Skill, SkillContext } from '@frontmcp/sdk';

// URL-based instructions fetched at build time
@Skill({
  name: 'api-standards',
  description: 'REST API design standards',
  instructions: { url: 'https://docs.example.com/standards/api-design.md' },
})
class ApiStandardsSkill extends SkillContext {}

@App({
  name: 'standards-app',
  skills: [CodingStandards, DeployGuide, ApiStandardsSkill],
})
class StandardsApp {}

@FrontMcp({
  info: { name: 'dev-server', version: '1.0.0' },
  apps: [StandardsApp],
})
class DevServer {}