handling-bc-files

Uploads and downloads files using InStream/OutStream, attaches documents to records via Table 1173, imports and exports CSV/XML with XMLport, and stores blobs in Azure Storage. Use when adding file attachments to sales orders, importing data from CSV, exporting reports to files, or connecting to Azure Blob Storage.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A concise, actionable, well-structured code skill with explicit validation gates and good external linking. The main gaps are placeholder-substitution templates, missing error-recovery feedback loops, and reference material that is inlined rather than split into bundle files.

Suggestions

Add an explicit error-recovery feedback loop to the validation gates (e.g., 'If a gate fails, inspect the stream/blob state, fix, and re-run') to reach the score-5 workflow anchor.

Resolve or clearly annotate the placeholders (<SourceTable>, <Record>."<KeyField>", <ID>, <PREFIX>) with a worked example so the snippets are copy-paste ready.

Move the JSON/XML Quick Reference and Persistent Blob sections into separate reference files under references/ and link to them from SKILL.md to improve progressive disclosure.

Dimension	Reasoning	Score
Conciseness	Lean, code-first content with terse annotations ('Key properties:', 'Requires:') and no padding about what Business Central is; a few sections (Persistent Blob, JSON/XML quick reference) edge slightly beyond core file I/O but mostly earn their place, sitting just below the fully-lean anchor.	4 / 5
Actionability	Concrete, executable AL snippets for upload, download, attachments, XMLport, Azure Blob, and persistent blobs, but templates use placeholders like '<SourceTable>', '<Record>."<KeyField>"', '<ID>', and '<PREFIX>' that require substitution before they run, matching the score-4 'minor gaps' anchor.	4 / 5
Workflow Clarity	A four-step procedure is clearly sequenced and a 'Validation Gates' section supplies explicit checkpoints after each step, but no error-recovery feedback loop ('if validation fails, fix and retry') is described, which keeps it below the score-5 anchor.	4 / 5
Progressive Disclosure	Well-organized into clearly headed sections with one-level-deep external links to Microsoft Learn and no nested references; since no bundle files are provided, the JSON/XML and Persistent Blob reference material is inlined rather than split out, a minor organization gap versus the score-5 anchor.	4 / 5
	Total	16 / 20 Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, specific description that pairs concrete AL file-handling capabilities with explicit natural-language triggers and a clearly bounded niche. The only minor gap is a few missing synonyms and file extensions in the trigger terms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions—'Uploads and downloads files using InStream/OutStream', 'attaches documents to records via Table 1173', 'imports and exports CSV/XML with XMLport', 'stores blobs in Azure Storage'—covering the file-handling domain comprehensively, matching the score-5 anchor.	5 / 5
Completeness	Explicitly answers both 'what' (the four concrete file operations) and 'when' via a concrete 'Use when adding file attachments to sales orders, importing data from CSV, exporting reports to files, or connecting to Azure Blob Storage' clause, matching the score-5 anchor.	5 / 5
Trigger Term Quality	Good natural-trigger coverage ('adding file attachments to sales orders', 'importing data from CSV', 'exporting reports to files', 'connecting to Azure Blob Storage'), but a few synonyms/file extensions (e.g. .csv, .xml, 'download') are missing, so it sits above the midpoint rather than at fully comprehensive.	4 / 5
Distinctiveness Conflict Risk	Domain-specific tokens (InStream/OutStream, Table 1173, XMLport, Azure Blob Storage) carve a clear Business Central file-handling niche with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: emgreppi/Business-Central-AI-Skill
Path: handling-bc-files/SKILL.md
Commit: 52f8705

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.