New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Skill Agent Instructions

by javiarmesto in javiarmesto/ALDC-AL-Development-Collection

Generate, review, and optimize natural language instructions for Business Central agents (Designer or SDK).

MITAuto-check passedAgent Workflows

Install Skill Agent Instructions

skills CLI
$ npx skills add javiarmesto/ALDC-AL-Development-Collection --skill skill-agent-instructions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install javiarmesto/ALDC-AL-Development-Collection skill-agent-instructions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/javiarmesto/ALDC-AL-Development-Collection.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-agent-instructions .claude/skills/skill-agent-instructions && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-agent-instructions
GitHub stars
109
Token cost
~2.8k tokens
SKILL.md length
1,060 words
Files
4 (incl. references)
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Generate, review, and optimize natural language instructions for Business Central agents (Designer or SDK).

  • Works in 3 steps: RESPONSIBILITY (one line) → GUIDELINES (cross-task rules) → INSTRUCTIONS (step-by-step per task)
  • : agent instructions
  • SKILL.md covers Storage modes, Key facts about the runtime, Framework: Responsibilities →… and Official runtime keywords, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Skill Agent Instructions is an agent skill from javiarmesto/ALDC-AL-Development-Collection. Generate, review, and optimize natural language instructions for Business Central agents (Designer or SDK). Triggers on: agent instructions, InstructionsV1.txt, InstructionsV2.txt, MEMORIZE, qualification rules, agent behavior, instruction keywords, agent task instructions, iterate instructions, or improve agent accuracy. Single source of truth for the Responsibilities-Guidelines-Instructions framework and runtime keywords.

Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/agent-keywords-reference.md`).

It sits in Agent Workflows, covering Agent instruction files. The repository describes itself as: AL development toolkit for Business Central with specialist agents, skills and review workflows for Copilot, Claude Code and Codex. The licence is MIT.

When your agent uses it

  • : agent instructions
  • InstructionsV1.txt
  • InstructionsV2.txt
  • Qualification rules

Example prompts

  • “/skill-agent-instructions”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. RESPONSIBILITY (one line)
  2. GUIDELINES (cross-task rules)
  3. INSTRUCTIONS (step-by-step per task)

What it can do on your machine

Read from SKILL.md and the folder at commit 4f99d7d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • learn.microsoft.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Agent Instructions loads about 2.8k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 113 tokens; SKILL.md has 1,060 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~2.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from javiarmesto/ALDC-AL-Development-Collection at commit 4f99d7d, republished under its MIT licence (© javiarmesto). 1,060 words, ~2,820 tokens.

Download SKILL.mdSave it as .claude/skills/skill-agent-instructions/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
skill-agent-instructions
description
Generate, review, and optimize natural language instructions for Business Central agents (Designer or SDK). Triggers on: agent instructions, InstructionsV1.txt, InstructionsV2.txt, MEMORIZE, qualification rules, agent behavior, instruction keywords, agent task instructions, iterate instructions, or improve agent accuracy. Single source of truth for the Responsibilities-Guidelines-Instructions framework and runtime keywords.
argument-hint
Describe the agent's purpose and tasks, or paste existing instructions to review

BC Agent Instructions Skill

Single source of truth for writing the natural-language instructions that guide Business Central agents. These instructions tell the agent runtime how to navigate the UI, read/set fields, invoke actions, and communicate with users.

For SDK architecture and how instructions are loaded see skill-agent-toolkit. For task-creation patterns (Public API, attachments, multi-turn) see skill-agent-task-patterns.

Storage modes

ModeStorageLoaded by
SDK.resources/Instructions/InstructionsV1.txtNavApp.GetResourceAsText() → SecretText → Agent.SetInstructions()
DesignerPaste into Agent Designer wizard text fieldRuntime reads directly from configuration

References:

Key facts about the runtime

  • Instructions are the PRIMARY lever for controlling agent behavior
  • The runtime has specific tools: field setting, lookups, action invocation, page navigation, email composition
  • Instructions must use specific keywords to activate these tools effectively
  • Only English is fully supported — safeguards are optimized for English
  • Shorter, well-structured instructions often outperform verbose ones
  • The agent retains action history but NOT page state — use MEMORIZE

Framework: Responsibilities → Guidelines → Instructions

Every instruction file follows this three-part structure.

1. RESPONSIBILITY (one line)

A single sentence defining the agent's accountability. Anchors all behavior.

**RESPONSIBILITY**: {What the agent is accountable for — one sentence}

Rules:

  • One sentence only — no paragraphs
  • State the business outcome, not technical implementation
  • Include the key domain nouns ("leads", "sales orders", "credit checks")
2. GUIDELINES (cross-task rules)

Rules that apply across all tasks.

**GUIDELINES**:
- ALWAYS {mandatory behavior}
- DO NOT {prohibited action}
- ALWAYS {safety/review gate}

Rules:

  • ALWAYS (bold) for mandatory behaviors
  • DO NOT (bold) for prohibited actions
  • Gate ALL critical actions (posting, sending, releasing, deleting) with user intervention
  • Include data access boundaries (read-only vs. read-write)
  • Include reply/output keywords the agent should use for structured responses
  • Keep to 3-7 guidelines — more causes confusion
3. INSTRUCTIONS (step-by-step per task)

Ordered steps for each task, using runtime keywords.

**INSTRUCTIONS**:

## Task: {Task Name}

1. {Action using keyword}
   a. {Sub-step with detail}
   b. {Sub-step with detail}
2. If {condition}: {action}
   a. **DO NOT** {prohibited action in this context}
3. {Next action}

Rules:

  • One ## Task: section per distinct workflow
  • Numbered steps with lettered sub-steps
  • Use official keywords (table below) to activate runtime tools
  • Place MEMORIZE BEFORE the value is needed in later steps
  • Include error handling at the end of each task
  • Provide example formats for memorized data

Official runtime keywords

KeywordRuntime toolUsage
Navigate to "{Page Name}"Page navigationOpens a page. Name MUST match the agent's profile pages exactly.
Search for {value} in "{Field}"List filteringFilters a list page by a field value.
Set field "{Field}" to {value}Field setterSets a field. Field name must match the page exactly.
Use lookupLookup triggerOpens a lookup on the current field.
Invoke action "{Action}"Action invocationTriggers a page action. Name must match the action caption exactly.
Read "{Field}"Value retrievalReads a field's current value for decision-making.
**Memorize**State retentionStores a key-value pair for reference in later steps.
**Reply**Message outputAgent responds to the task. All outgoing messages require review.
Write an emailEmail compositionComposes an email. Requires user review before sending.
Request user interventionHuman-in-the-loopPauses the agent and asks the user for input/decision.
Request a reviewReview gateAsks user to review work before the agent continues.
Ask for assistanceHelp requestAgent seeks help when stuck or encounters an error.

Critical keyword rules:

  • Page, field, and action names MUST match exactly what the agent sees in its profile
  • MEMORIZE must include an example format: **Memorize**: "Customer: ACME Corp | Credit: 50,000"
  • Reply keywords should include structured output patterns for programmatic parsing
  • The agent does NOT have access to "Tell Me" — all navigation must be via explicit page names

Step-by-step creation workflow

  1. Gather inputs: agent purpose (1 sentence), pages in scope, fields to read/write, actions to invoke, decision criteria, output format, safety gates
  2. Draft RESPONSIBILITY: one sentence with domain + outcome
  3. Draft GUIDELINES: 3-7 rules — at least one ALWAYS, one DO NOT, one safety gate
  4. Draft INSTRUCTIONS per task: navigate → read+MEMORIZE → branch → execute → Reply
  5. Validate with the checklist below
  6. Test and iterate: deploy → observe timeline → refine. Simpler instructions often perform better.
Show full SKILL.md (435 more words)Show less

Validation checklist

  • Page names match agent profile and page customizations exactly
  • Field names match the fields visible on the agent's pages exactly
  • Action names match the action captions visible on the agent's pages
  • MEMORIZE placed BEFORE the memorized value is needed in later steps
  • MEMORIZE includes example format (e.g., "Key: value | Key: value")
  • All critical actions (posting, sending, releasing, deleting) gated by user intervention or review
  • Written in English — agent safeguards are optimized for English
  • Environment-agnostic — no hardcoded company names, URLs, user IDs
  • Concise — no redundant prose; each line serves a purpose
  • Error handling section covers: not found, unavailable pages, failed actions
  • Reply formats use consistent keywords for structured parsing
  • No references to "Tell Me" (agents cannot use it)
  • Guidelines count is 3-7 (not too few, not too many)
  • Each task has numbered steps with lettered sub-steps

Anti-patterns

Anti-patternProblemFix
No MEMORIZE before cross-page useAgent loses field values when navigating awayAdd MEMORIZE immediately after reading the value
Vague field names ("the amount")Agent cannot resolve which field to setUse exact field name: Set field "Estimated Budget"
Missing error handlingAgent halts or produces confusing outputAdd error Reply for each failure scenario
Too many guidelines (>7)Agent behavior becomes inconsistentConsolidate into fewer, broader rules
Referencing pages not in profileAgent cannot navigate thereVerify all pages are in the agent's profile
No user intervention on critical opsAgent posts/sends/releases without human checkAdd Request user intervention or Request a review
Contradictory guidelinesUnpredictable behavior on each runRemove contradictions, prioritize by specificity
Hard-coded environment valuesInstructions break across environmentsUse generic references, let setup tables hold specifics
Referencing specific tools by nameTool renames cause regressionsDescribe WHAT to do, not WHICH tool to use

Advanced concepts

Page-specific dynamic instructions

For SDK agents, IAgentTaskExecution.GetAgentTaskPageContext injects dynamic context per page using Liquid-style conditionals:

Consider the following fields:
{% if page.id == 42 %}
Field "The Answer" — the meaning of the universe
{% else %}
Field "Business Data" — standard business field
{% endif %}
Multi-task instructions

When an agent handles multiple tasks, create separate ## Task: sections. The agent selects the task based on input message content. Use distinct keywords in the Reply for programmatic routing:

## Task: Qualify Lead
...Reply: "qualification successful | ..."

## Task: Re-evaluate Lead
...Reply: "re-evaluation complete | ..."
Agent-to-agent handoff

When one agent creates tasks for another:

  • Verify the target agent is configured (check setup fields)
  • Use page actions that trigger task creation (the action handles the API call)
  • MEMORIZE the handoff result for the final reply
  • Include fallback instructions if the handoff action is unavailable

Examples

Load an example only when you need a concrete template:

© javiarmesto, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/skill-agent-instructions of javiarmesto/ALDC-AL-Development-Collection.

  • SKILL.md
  • examples/agent-advanced-instructions.txt
  • examples/agent-simple-instructions.txt
  • references/agent-keywords-reference.md

Open the folder on GitHubat commit 4f99d7d

Compare with similar skills

Skill Agent Instructions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Agent Instructions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Agent Instructions this skilljaviarmesto/ALDC-AL-Development-Collection109—~2.8kAutomated safety check: PassMIT
Agent Instructionsmurphytrueman/design-system-ops206—~2.3kAutomated safety check: PassMIT
ReflectNikiforovAll/claude-code-rules141—~1.8kAutomated safety check: PassApache-2.0
Research Setupbrycewang-stanford/Auto-Empirical-Research-Skills4.5k—~1.2kAutomated safety check: PassCustom licence
Using Agent Skillsaddyosmani/agent-skills103k4 repos~2.4kAutomated safety check: PassMIT
Claude ReflectBayramAnnakov/claude-reflect1.7k2 repos~627Automated safety check: PassMIT

Similar skills

  • Agent Instructions

    murphytrueman/design-system-ops

    Write the AGENTS.md that tells coding agents how to use this design system: where things live, sourced rules, how to check work, what not to do; Claude, Cursor or Copilot pointers on request.

    206 GitHub stars~2.3k tokensUpdated 15 days ago
    Agent WorkflowsAuto-check passed

  • Reflect

    NikiforovAll/claude-code-rules

    Analyze a Claude Code session for "wrong-turn" moments (corrections, retries, waste, reversals, dead-ends) and produce an interactive HTML dashboard with copy-able recommendations (CLAUDE.md rules…

    141 GitHub stars~1.8k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed

  • Research Setup

    brycewang-stanford/Auto-Empirical-Research-Skills

    Interactive setup wizard that configures a new project for the social-science-research plugin.

    4.5k GitHub stars~1.2k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed

  • Using Agent Skills

    addyosmani/agent-skills

    Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.

    103k GitHub starsUsed in 4 repos~2.4k tokens
    Agent WorkflowsAuto-check passed

  • Claude Reflect

    BayramAnnakov/claude-reflect

    Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md.

    1.7k GitHub starsUsed in 2 repos~627 tokens
    Agent WorkflowsAuto-check passed

  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed

More from javiarmesto/ALDC-AL-Development-Collection

All 14 skills in this repo

  • Skill API

    javiarmesto/ALDC-AL-Development-Collection

    AL API development patterns for Business Central. An agent skill from javiarmesto/ALDC-AL-Development-Collection.

    109 GitHub stars~3.5k tokensUpdated 2 days ago
    Auto-check passed

  • Skill Copilot

    javiarmesto/ALDC-AL-Development-Collection

    AL Copilot capability development for Business Central. An agent skill from javiarmesto/ALDC-AL-Development-Collection.

    109 GitHub stars~3.5k tokensUpdated 2 days ago
    Auto-check passed

  • Skill Migrate

    javiarmesto/ALDC-AL-Development-Collection

    AL version migration for Business Central. An agent skill from javiarmesto/ALDC-AL-Development-Collection.

    109 GitHub stars~3k tokensUpdated 2 days ago
    Auto-check passed

  • Skill Agent Task Patterns

    javiarmesto/ALDC-AL-Development-Collection

    Agent SDK task integration patterns for Business Central. An agent skill from javiarmesto/ALDC-AL-Development-Collection.

    109 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed

  • Skill Agent Toolkit

    javiarmesto/ALDC-AL-Development-Collection

    Build, configure, and integrate Business Central agents using the AI Development Toolkit and Agent SDK.

    109 GitHub stars~4.4k tokensUpdated 2 days ago
    Auto-check passed

  • Skill Debug

    javiarmesto/ALDC-AL-Development-Collection

    AL debugging and diagnostics for Business Central. An agent skill from javiarmesto/ALDC-AL-Development-Collection.

    109 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed

Categories

Questions about Skill Agent Instructions

What does Skill Agent Instructions do?

Generate, review, and optimize natural language instructions for Business Central agents (Designer or SDK). Skill Agent Instructions is an agent skill from javiarmesto/ALDC-AL-Development-Collection. Generate, review, and optimize natural language instructions for Business Central agents (Designer or SDK).

When should I use Skill Agent Instructions?

Skill Agent Instructions fits situations like: : agent instructions; instructionsV1.txt; instructionsV2.txt; qualification rules.

How do I install Skill Agent Instructions in Claude Code?

Run `npx skills add javiarmesto/ALDC-AL-Development-Collection --skill skill-agent-instructions -a claude-code`. Or copy the skill folder (skills/skill-agent-instructions in javiarmesto/ALDC-AL-Development-Collection) into .claude/skills/skill-agent-instructions in your project. Claude Code loads it when a task matches its description.

How do I install Skill Agent Instructions in Codex?

Run `npx skills add javiarmesto/ALDC-AL-Development-Collection --skill skill-agent-instructions -a codex`. Or copy the skill folder (skills/skill-agent-instructions in javiarmesto/ALDC-AL-Development-Collection) into .agents/skills/skill-agent-instructions in your project. Codex loads it when a task matches its description.

Can I use Skill Agent Instructions in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add javiarmesto/ALDC-AL-Development-Collection --skill skill-agent-instructions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-agent-instructions, .gemini/skills/skill-agent-instructions, .github/skills/skill-agent-instructions and .opencode/skills/skill-agent-instructions in your project.

What does Skill Agent Instructions need to run?

SKILL.md names no scripts, command-line tools or credentials: Skill Agent Instructions is instructions for the agent only.

Does Skill Agent Instructions access the network?

SKILL.md names 1 domain. As links in the text: learn.microsoft.com. This is read from the text; nothing was executed.

Is Skill Agent Instructions safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Agent Instructions use?

Skill Agent Instructions is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Agent Instructions use?

About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1k tokens, read only when the agent opens those files.

What are the alternatives to Skill Agent Instructions?

Skills that share tags, products or a category with Skill Agent Instructions: Agent Instructions (murphytrueman/design-system-ops, 206 stars), Reflect (NikiforovAll/claude-code-rules, 141 stars), Research Setup (brycewang-stanford/Auto-Empirical-Research-Skills, 4.5k stars) and Using Agent Skills (addyosmani/agent-skills, 103k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Agent Instructions?

javiarmesto (a GitHub user) maintains it in javiarmesto/ALDC-AL-Development-Collection, which has 109 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 7, 2026.

Source: javiarmesto/ALDC-AL-Development-Collection on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.