Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

PI Asset Identification & Data Query · matlab | DecimalAI

databy matlab

PI Asset Identification & Data Query

matlab/matlab-find-pi-assets

Source matlab/matlab-agentic-toolkit ↗License NOASSERTION

Find and query PI assets using MATLAB's Industrial Communication Toolbox. Two paths: (1) direct PI tag lookup via piclient + tags when user provides a tag name or description (R2022a+), (2) Asset Framework navigation via afclient when user needs element/attribute hierarchy (R2026a+).

SkillScore100Maintained

Automatic

Data Engineer pack

Last verified 8/16/2026

What it changes

Passed 21 of 21 test cases with the skill, and 5 of 21 without it.

Without skill23%

With skill100%

Checks it passed that the model alone missed

Uses tags to locate the tag name.
Uses tags to search for matching tag names.
Uses afclient for PI Asset Framework navigation.

and 24 more in the full report

17 fixed5 passed either way0 still failing0 broke

Pass-rate lift: +77 pp
Tokens: +190%
Agent turns: 0%
Response time: -56%

Model gemini-3.6-flashMeasured 8/16/2026v122 of 22 cases passed with skill · 21 comparable

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/matlab-matlab-find-pi-assets/SKILL.md https://app.decimal.ai/s/matlab-matlab-find-pi-assets/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add matlab-matlab-find-pi-assets, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/matlab-matlab-find-pi-assets/ and pins it in .decimal/skills.lock

decimalai skills add matlab-matlab-find-pi-assets

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/matlab-matlab-find-pi-assets/SKILL.md https://app.decimal.ai/s/matlab-matlab-find-pi-assets/SKILL.md

Raw file: /s/matlab-matlab-find-pi-assets/SKILL.md ↗ · machine-readable summary at /s/matlab-matlab-find-pi-assets.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 16 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 16

Prompt

A user explicitly provides a PI tag name 'PUMP101.FLOW'. Write the most direct MATLAB code to connect to PI Data Archive server 'PIServer01' and retrieve its current snapshot reading, avoiding unnecessary AF hierarchy browsing.

What was checked, without and with the skill
Checked	Without skill	With skill
Uses piclient to connect directly to the PI Data Archive server.	Missed	Passed
Uses tags to locate the tag name.	Missed	Passed

case-21 · gemini-3.6-flash · 8/16/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md408 lines2 files

PI Asset Identification & Data Query

Connect to PI systems, locate assets, and read historical data using MATLAB's Industrial Communication Toolbox wrappers — not raw .NET SDK interop.

Release Requirements

Workflow	Minimum Release	Functions
A: PI Data Archive (tag lookup)	R2022a+	`piclient`, `tags`, `read` (piclient)
B: PI Asset Framework (AF navigation)	R2026a+	`afclient`, `findElementByName`, `getAttributes`, `readHistory`, etc.

When to Use

User wants to find or query PI Asset Framework elements or attributes
User provides a PI tag name or tag description and wants to look it up
User needs historical data from a PI AF attribute or PI tag
User mentions PI AF server, PI Data Archive, OSIsoft, AVEVA PI, or asset hierarchy
User wants to list elements by template (e.g., "all generation units")

When NOT to Use

Creating or modifying AF elements/templates (administration)
Real-time streaming, event frames, or notifications
PI Vision or PI Web API access
Writing data back to PI AF or PI Data Archive

Decision Logic

Choose the workflow based on what information the user provides:

User provides	Workflow	Entry function
A PI tag name (e.g., `"GU1.ActivePower"`)	A: Direct Tag Lookup	`piclient` → `tags`
A tag description or partial tag name	A: Direct Tag Lookup	`piclient` → `tags`
An element name, template, or attribute in AF	B: AF Navigation	`afclient`
A request to browse/explore the asset hierarchy	B: AF Navigation	`afclient`

If unclear, ask the user: "Do you have a specific PI tag name, or do you need to navigate the Asset Framework hierarchy?"

Workflow A: Direct Tag Lookup (R2022a+)

Track record

Benchmark

21 / 21

test cases passed, vs 5 / 21 without

Adoption

Users: 4
Times used: 127

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

matlab / matlab-agentic-toolkit

skills-catalog/test-and-measurement/matlab-find-pi-assets/SKILL.md

View on GitHub ↗

License https://www.mathworks.com/content/dam/mathworks/license/pmrl/license.mdImported 8/3/2026Version v1Bundled 1 file

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

PI Asset Identification & Data Query

Release Requirements

When to Use

When NOT to Use

Decision Logic

Workflow A: Direct Tag Lookup (R2022a+)

Track record

Benchmark

Adoption

SkillSafety

Source

Related skills