poml-guide
Microsoft POML（Prompt Orchestration Markup Language）の構文、タグリファレンス、 プロンプト設計パターンを提供する。「POMLとは」「POMLの書き方」「roleタグ」「taskタグ」 「POMLでプロンプトを構造化したい」「POML validate」「POML render」などPOML関連の 質問や .poml ファイルの編集時に使用する。
Best use case
poml-guide is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Microsoft POML（Prompt Orchestration Markup Language）の構文、タグリファレンス、 プロンプト設計パターンを提供する。「POMLとは」「POMLの書き方」「roleタグ」「taskタグ」 「POMLでプロンプトを構造化したい」「POML validate」「POML render」などPOML関連の 質問や .poml ファイルの編集時に使用する。
Teams using poml-guide should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/poml-guide/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How poml-guide Compares
| Feature / Agent | poml-guide | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Microsoft POML（Prompt Orchestration Markup Language）の構文、タグリファレンス、 プロンプト設計パターンを提供する。「POMLとは」「POMLの書き方」「roleタグ」「taskタグ」 「POMLでプロンプトを構造化したい」「POML validate」「POML render」などPOML関連の 質問や .poml ファイルの編集時に使用する。
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# POML (Prompt Orchestration Markup Language) Guide
Microsoft が開発した XML ベースのマークアップ言語。AI Agent への構造化した指示記述に使用する。
## Quick Reference
| タグ | 用途 | 主要属性 |
|---|---|---|
| `<poml>` | ルート要素 | `version` |
| `<role>` | エージェントのペルソナ定義 | - |
| `<task>` | 実行タスクの指定 | - |
| `<example>` | Few-shot 用サンプル | `type` |
| `<output-format>` | 出力形式の指定 | - |
| `<document>` | 参照ドキュメント埋め込み | `src`, `type` |
| `<table>` | 表形式データ | `src`, `format` |
| `<img>` | 画像参照 | `src`, `alt` |
| `<stylesheet>` | 出力スタイル制御 | - |
| `<output-schema>` | JSON Schema 定義 | - |
| `<let>` | 変数定義 | `name` |
## 最小テンプレート
```xml
<poml>
<role>あなたは{{role_name}}です。</role>
<task>{{task_description}}</task>
</poml>
```
## CLI コマンド
```bash
# インストール
pip install poml
# バリデーション
poml check <file.poml>
# レンダリング（プレーンテキスト変換）
poml render <file.poml>
# 変数を渡してレンダリング
poml render <file.poml> --var key=value
```
## 詳細ドキュメント
- [poml-syntax.md](./poml-syntax.md) - ファイル構造・テンプレート変数・条件分岐・ループ
- [poml-tags-reference.md](./poml-tags-reference.md) - 全タグの属性仕様と使用例
- [poml-patterns.md](./poml-patterns.md) - 用途別設計パターン集
- [poml-stylesheet.md](./poml-stylesheet.md) - stylesheet によるフォーマット制御Related Skills
Subagents Guide
Specialized AI assistants for task-specific workflows with separate context. Learn when to delegate, configure tools, and apply best practices.
dotfiles-guide
Use when adding new configurations, packages, or modules to this dotfiles repository. Covers file placement, package lists, and module creation.
cs-guide-writer
CS 학습 문서를 작성합니다. "오늘의 CS", "CS 정리", "{주제} 정리해줘", "최근 이슈 CS" 요청 시 사용하세요.
backend-dev-guidelines
Opinionated backend development standards for Node.js + Express + TypeScript microservices. Covers layered architecture, BaseController pattern, dependency injection, Prisma repositories, Zod valid...
ashby-api-guide
This skill should be used when the user asks about "Ashby API", "how to use Ashby tools", "Ashby authentication", "Ashby MCP tools", "what can I do with Ashby", or needs help understanding available Ashby operations. Provides complete API documentation and tool usage guidance.
api-style-guide
Style and formatting rules for API/SDK documentation, samples, and tutorials.
aiwf:backend-dev-guidelines
Comprehensive backend development guide for Node.js/Express/TypeScript microservices. Use when creating routes, controllers, services, repositories, middleware, or working with Express APIs, Prisma database access, Sentry error tracking, Zod validation, unifiedConfig, dependency injection, or async patterns. Covers layered architecture (routes → controllers → services → repositories), BaseController pattern, error handling, performance monitoring, testing strategies, and migration from legacy patterns.
migration-guides
Migration guides - from other AI tools, version upgrades, config migration. Use when switching from Cursor, Copilot, or Cody, upgrading Claude Code versions, or migrating configurations and customizations.
Claude Code Guide
Master guide for using Claude Code effectively. Includes configuration templates, prompting strategies "Thinking" keywords, debugging techniques, and best practices for interacting with the agent.
ai-llm-skills-guide
Guide for AI Agents and LLM development skills including RAG, multi-agent systems, prompt engineering, memory systems, and context engineering.
ai-dev-guidelines
Comprehensive AI/ML development guide for LangChain, LangGraph, and ML model integration in FastAPI. Use when building LLM applications, agents, RAG systems, sentiment analysis, aspect-based analysis, chain orchestration, prompt engineering, vector stores, embeddings, or integrating ML models with FastAPI endpoints. Covers LangChain patterns, LangGraph state machines, model deployment, API integration, streaming, error handling, and best practices.
agents-md-guide
Guide for using and supporting the AGENTS.md standard in VS Code. Use this when asked about AGENTS.md, custom instructions, or repo-level AI agent configuration.