Custom Service Authoring

Build or extend a D365FO custom service (JSON/SOAP REST endpoint) using the AxService + AxServiceGroup + SysOperation or plain class pattern. Invoke when the user asks to "create a custom service", "expose an X++ method as a REST endpoint", "build a service class", or "register a service group".

49 stars 26 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add dynamics365ninja/d365fo-cli --skill custom-service-authoring
Manual install
git clone --depth 1 https://github.com/dynamics365ninja/d365fo-cli.git /tmp/d365fo-cli
mkdir -p ~/.claude/skills
cp -r /tmp/d365fo-cli/skills/anthropic/custom-service-authoring ~/.claude/skills/custom-service-authoring

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

> ⛔ **NEVER write X++ AOT XML files directly** via PowerShell, terminal file commands (`Set-Content`, `Out-File`, `New-Item`), editor write tools, or any raw text approach. The XML schema is proprietary. **ALWAYS use `d365fo generate …` commands** to produce correct AOT XML. If `d365fo` is unavailable in PATH, stop and ask the user to install it.

# Custom Service Authoring in D365FO

> Custom services expose X++ methods as synchronous REST/SOAP endpoints.
> They are ideal for real-time inbound integrations (e.g. Logic Apps calling
> D365FO to create a record, or Power Automate looking up a balance).

**Reference:** https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/dev-ref/xpp-attribute-classes

---

## Pattern overview

A D365FO custom service requires three artifacts:

```
1. Service class  — a plain X++ class (no class-level service attribute
   exists in X++ — the AxService object below is what wires it up)
   - Parameters/return types use [DataContractAttribute] classes

2. AxService XML  — declares the service class + operation bindings
   (each AxServiceOperation maps an operation Name to a Method on the class)

3. AxServiceGroup XML  — registers the service into a named group
   (determines the REST URL path segment)
```

## Pre-flight
Read the full skill on GitHub

Details

Skill name
custom-service-authoring
Path
skills/anthropic/custom-service-authoring/SKILL.md
Repo updated
16 November 2026

FAQ

What does the Custom Service Authoring skill do?

Build or extend a D365FO custom service (JSON/SOAP REST endpoint) using the AxService + AxServiceGroup + SysOperation or plain class pattern. Invoke when the user asks to "create a custom service", "expose an X++ method as a REST endpoint", "build a service class", or "register a service group".

How do I install the Custom Service Authoring skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add dynamics365ninja/d365fo-cli --skill custom-service-authoring. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Custom Service Authoring popular?

It lives in dynamics365ninja/d365fo-cli, which has 49 GitHub stars and 26 forks.

Related skills

Analytics and Er

49

dynamics365ninja/d365fo-cli

Model the D365FO analytical and document-generation surfaces — aggregate measurements and the entity store, tiles/cues and KPIs, and Electronic Reporting (ER). Invoke when the user asks about a workspace tile, a KPI, an aggregate measurement, the entity store, Power BI content, or running/binding an ER format.

Data & Analytics26

Barcode Scanning

49

dynamics365ninja/d365fo-cli

Barcodes and scanner input in D365FO — printing vs scanning are unrelated code paths, GS1-128 application identifiers, item-barcode resolution, and where the platform parses a scan for you. Invoke when the user mentions barcodes, GS1, GTIN, SSCC, scanning, scanners, item barcodes, or barcode setup.

AI, LLMs & Agents26

Build Error Triage

49

dynamics365ninja/d365fo-cli

Turn a D365FO compiler, best-practice, or runtime error into the specific fix it calls for. Invoke when the user pastes a build log, an xppc message, a BP violation, or an infolog stack trace and asks what it means or how to fix it.

AI, LLMs & Agents26

Data Entity Scaffolding

49

dynamics365ninja/d365fo-cli

Scaffold an AxDataEntityView (data entity) in D365 Finance & Operations for OData / DMF (Data Management Framework) integration. Use when the user asks to "create a data entity", "expose a table to OData", or "scaffold an entity for DMF".

AI, LLMs & Agents26

Coc Extension Authoring

49

dynamics365ninja/d365fo-cli

Author a Chain-of-Command extension in D365FO without duplicating existing wrappers. Use when the user asks to "wrap a method", "add a CoC", or "modify behavior of standard method".

AI, LLMs & Agents26

Document Attachments

49

dynamics365ninja/d365fo-cli

Attach files to a record in D365FO — the DocuRef/DocuValue/DocuType tables, DocumentManagement::attachFile and its nine arguments, and reading an attachment back. Invoke when the user asks to attach a document, store a file against a record, read attachments, or debug an attachment that saved with the wrong name.

AI, LLMs & Agents26

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.