TIA Portal Openness Development Kit

A growing collection of AI extensions that work with Siemens TIA Portal.

This plugin is a help set for AI coding clients, not an executable library or automation service. It provides skills focused on TIA Portal Openness. Other TIA Portal skill sets can be published as separate plugins in this repository.

Install with GitHub Copilot CLI

The supported installation path uses the marketplace catalog in this repository.

copilot plugin marketplace add siemens/tia-portal-ai-extensions

Install the plugin:

copilot plugin install tia-portal-openness-development-kit@tia-portal-ai-extensions

Verify the installation:
```
copilot plugin list
```
In an interactive Copilot CLI session, run /skills list and confirm that the plugin's skills are available.

Update

copilot plugin update tia-portal-openness-development-kit

Uninstall

copilot plugin uninstall tia-portal-openness-development-kit
copilot plugin marketplace remove tia-portal-ai-extensions

Uninstall the plugin before removing its marketplace. Copilot CLI refuses to remove a marketplace that still supplies installed plugins unless forced.

Direct installation from a local path or repository may still be useful during development, but Copilot CLI 1.0.86 marks direct plugin installs as deprecated. The marketplace flow above is the release installation path.

Compatibility and prerequisites

Component	Status
GitHub Copilot CLI	Installation and discovery of all 32 skills verified with version 1.0.86
Agent Plugins	`plugin.json` follows Agent Plugins 1.0
Copilot marketplace	The repository catalog points to this package
Agent Skills	Skills use the standard `skills/<name>/SKILL.md` layout within this package
TIA Portal	Content and SDK paths are based on TIA Portal V21; other versions are not verified
Operating system	Windows is required for TIA Portal and the Openness API

This plugin is developed against the official Agent Skills specification and Agent Plugins 1.0. It is tested and supported with GitHub Copilot CLI. Other compatible AI clients may be able to use the bundled skills, but they have not yet been verified and are not currently part of the supported client matrix.

Installing the plugin does not install TIA Portal, an Openness SDK, or any Siemens product license. To apply the current Openness guidance with TIA Portal, you need:

TIA Portal V21 with the product packages used by your application;
the matching assemblies under $(TiaPortalLocation)\PublicAPI\V21\net48\;
the licenses required by those TIA Portal products and options;
membership in the local Windows group Siemens TIA Openness; and
approval of the application in the TIA Portal Openness firewall.

There is no separate Openness product license, but the underlying products and options can require licenses. A GitHub Copilot entitlement may also be required to use Copilot CLI.

How it works

Ask Copilot CLI for help with a concrete TIA Portal Openness task. It selects relevant installed skills from their descriptions; you can also inspect the available skills with /skills list.

The plugin supplies Markdown guidance, code patterns, references, and project templates. It does not itself connect to TIA Portal or execute Openness operations.

Examples are based on the TIA Portal V21 API. Individual skills identify empirical findings or operations that still require live verification.

Included skills

Foundations and cross-cutting guidance

Skill	Description
`openness-base`	SDK discovery, assembly references, API versioning, type identifiers, and core prerequisites
`licensing-and-firewall`	Product licensing, Windows-group access, and Openness firewall authorization
`change-detection`	Project timestamps, fingerprints, PLC checksums, and Safety signatures
`performance-and-caching`	IPC-aware navigation, batching, caching, reference limits, and bulk-edit performance
`threading-and-concurrency`	Apartment state, thread affinity, serialization, and safe concurrent request handling

General

Skill	Description
`session-and-project`	TIA Portal session lifecycle and project open, save, archive, and close operations
`engineering-objects`	Exclusive access, transactions, services, attributes, object navigation, and identity

STEP 7

Skill	Description
`tags-and-tagtables`	PLC tag and tag-table operations, XML import/export, and user constants
`blocks`	Program and data blocks, import/export, compilation, protection, and cross-references
`devices-and-hardware`	Device creation, CPU discovery, software containers, networks, and transfer areas
`online-and-download`	Online connections and software download
`security`	UMAC roles, users, device-function rights, and PLC protection
`libraries-and-alarms`	Global libraries, master copies, alarm text lists, Safety administration, and units
`technology-objects`	Technology-object creation, discovery, and parameterization
`global-library`	Global-library traversal, type classification, placement, and rename patterns
`sw-units`	PLC-wide discovery and creation across root and software-unit scopes
`software-hierarchy`	PLC software hierarchy and routing through groups and software units
`openness-testing`	Live Openness integration-test architecture and runner prerequisites
`plc-data-types`	PLC data types, recursive search, and UDT XML structure
`plc-safety-administration`	Fail-safe PLC settings, block-number assignment, and runtime groups
`simatic-sd`	SIMATIC SD documents, V21 import/export, parsing, and network insertion
`crash-diagnosis`	Hard-crash localization and safer object-tree inspection
`object-tree-walking`	Schema-free service, attribute, and composition traversal

Startdrive

Skill	Description
`drive-objects`	Drive-object access, activation, parameters, hardware projection, and online operations
`hardware-and-modules`	Motors, encoders, hardware catalog search, insertion, and type changes
`parameters`	Drive parameters, indexed values, bits, and BiCo wiring
`telegrams`	Main, safety, additional, and supplementary telegram configuration
`networks-and-drivecliq`	PROFINET and DriveCliq port connections
`safety-commissioning`	SINAMICS safety functions, checksums, and acceptance tests

DCC

Skill	Description
`drive-control-charts`	DCC chart import/export, blocks, pins, and parameter interconnection

Add-in development

Skill	Description
`tia-addin-scaffold`	Guided creation of packaged add-ins and standalone Openness applications

Discovery

Skill	Description
`openness-overview`	Overview and routing help for all skills in this plugin

Support

Use GitHub Issues for questions, bugs, and improvement suggestions.

For confidential or security-sensitive concerns, follow SECURITY.md instead of opening a public issue.

Community participation is governed by our Code of Conduct.

siemens/tia-portal-openness-development-kit