# Maf Adapter

> Provides validation, setup guidance, and a local test harness simulator to run skills within the Microsoft Agent Framework (MAF).

- Skill: `richfrem/maf-adapter` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add richfrem/maf-adapter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/richfrem/maf-adapter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: richfrem (https://skillmd.com/u/richfrem)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/richfrem/maf-adapter

---


# Microsoft Agent Framework (MAF) Adapter

This skill contains the integration specifications and simulation utilities to test and run `.md` agent skills inside Microsoft's MAF engine (v1.6/v1.7.0).

---

## 1. Local Simulation Harness

To test a skill in a simulated MAF execution host locally:
```bash
python3 plugins/cli-agents/scripts/test_harness.py \
  --skill plugins/exploration-cycle-plugin/skills/exploration-workflow/ \
  --input temp/sample_input.txt \
  --instruction "Analyze the repository"
```

---

## 2. Manifest Validation for MAF

Before loading a plugin manifest or skill into MAF, validate it against the target runtime criteria:
```bash
python3 plugins/cli-agents/scripts/test_harness.py --validate --plugin plugins/exploration-cycle-plugin
```

This verifies:
1. Manifest `plugin.json` matches standard keys and is free of banned fields.
2. All commands defined have their matching target files on the correct path.
3. Frontmatter fences (`---`) are valid and contain the required name/description.

