skills/c8y-ui/SKILL.md
Guides developers to scaffold new projects e.g. to develop plugins, and implement clean, consistent HTML layouts aligned with the Cumulocity Codex design system foundations.
npx skillsauth add cumulocity-iot/cumulocity-skills c8y-uiInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are a Cumulocity UI expert.
Your role is to help developers write high-quality HTML following the Cumulocity design principles and as less custom CSS as possible as Cumulocity UI ships with a powerful toolset of styling classes.
| Topic | Description | Reference | |-------|-------------|-----------| | Foundation | Design system foundations including typography, grid, vertical rhythm, elevation/ shadows, and motion/animation | foundation | | Icons | How to display icons, find available icons, and supported icon sizes | icons | | Forms | Guidelines for creating accessible forms, form groups, and all input types | forms | | Pipes | Pipes transform data in Angular templates, providing formatting, filtering, and data manipulation capabilities | pipes | | Creating a New Project | Guidance on setting up a new Cumulocity web project, LTS dependency recommendations, and using the tutorial app for examples | new project |
If a topic is covered in the referenced documents, you must treat it as authoritative and defer to it over personal preference or general web advice.
When responding to layout, HTML, or UI-related questions, you should:
You do NOT:
tools
Scaffold a new Cumulocity application using the @c8y/websdk Angular schematic without human interaction. Covers Angular CLI installation, app generation, schematic setup, AI tools configuration, dev server, and build commands. Triggers: new app, scaffold, create application, ng add websdk, setup cumulocity app, new cumulocity project.
tools
Step-by-step guide to migrate a Cumulocity Web SDK application to a target version. Detects breaking changes with the ui-breaking-changes-cli, scaffolds a reference app at the target version with the new-app skill, compares key configuration files (app.ts, bootstrap.ts, angular.json, etc.), and finishes with a code-quality-analysis review. Triggers: migrate app, upgrade version, breaking changes, sdk upgrade, migrate cumulocity, upgrade websdk.
development
Complete guide to internationalizing a Cumulocity Web SDK application. Covers all approaches to annotating and translating text (gettext, translate pipe, translate directive, TranslateService), extracting strings, creating and updating .po files, overriding existing translations, and adding brand-new languages. Triggers: i18n, internationalization, add language, translate, translation, localization, l10n, new language, po file, gettext, TranslateService, language switcher.
development
Analyze Angular / Cumulocity Web SDK code for anti-patterns, bugs, and quality issues. Use when reviewing components, services, or modules for code quality, maintainability, performance, and correctness. Covers TypeScript best practices, Angular idioms, C8Y SDK usage patterns, and project-specific conventions. Triggers: code review, anti-pattern, quality check, refactor suggestion, style guide, bug analysis.