Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "uipath-boost",
"version": "0.2.0",
"version": "0.3.0",
"description": "Community engineering skills for better UiPath automation delivery.",
"author": {
"name": "1aifanatic",
Expand Down
4 changes: 2 additions & 2 deletions .codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "uipath-boost",
"version": "0.2.0",
"version": "0.3.0",
"description": "Community engineering skills for planning, designing, testing, releasing, operating, and explaining UiPath automations.",
"author": {
"name": "1aifanatic",
Expand All @@ -22,7 +22,7 @@
"interface": {
"displayName": "UiPath Boost",
"shortDescription": "Community engineering practices for UiPath delivery",
"longDescription": "Use 34 complementary skills for UiPath discovery, architecture, delivery continuity, testing discipline, release readiness, operational design, and knowledge transfer while official UiPath skills remain the source of product truth.",
"longDescription": "Use 35 complementary skills for UiPath discovery, architecture, diagram design, delivery continuity, testing discipline, release readiness, operational design, and knowledge transfer while official UiPath skills remain the source of product truth.",
"developerName": "1aifanatic",
"category": "Developer Tools",
"capabilities": [
Expand Down
7 changes: 7 additions & 0 deletions ACKNOWLEDGMENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,13 @@ Matt Pocock's repository is distributed under the
Boost retains this acknowledgment so the source of those design influences is
clear.

The `uipath-diagram-design` skill is a focused UiPath adaptation of the visual
grammar published in
[Kathryn Lavery's diagram-design repository](https://github.com/cathrynlavery/diagram-design).
The upstream project is distributed under the MIT License. UiPath Boost retains
the copyright notice, records the reviewed upstream commit, and describes its
modifications in [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md).

Current UiPath product commands, schemas, artifact validation, deployment,
tenant operations, and platform behavior remain owned by the
[official UiPath skills repository](https://github.com/UiPath/skills).
22 changes: 22 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,27 @@
# Changelog

## 0.3.0 - 2026-08-12

### Added

- Added `uipath-diagram-design`, a model-invoked skill for five
communication-grade UiPath diagram types: solution architecture, process
swimlane, interaction sequence, state and lifecycle, and deployment and
integration.
- Added synchronized HTML, SVG, and 1600x900 PNG examples for all five types.
- Added a standard-library Python exporter that extracts inline SVG and uses an
already installed Chrome, Edge, or Chromium browser for PNG rendering.
- Added a simple three-step README quick start and a detailed skill guide with
example prompts, before-and-after guidance, output selection, and official
UiPath handoffs.
- Added third-party attribution and the retained MIT notice for Kathryn
Lavery's `diagram-design` project.

### Changed

- Increased the catalog to 35 skills: 15 user-invoked and 20 model-invoked.
- Updated package and plugin metadata to version 0.3.0.

## 0.2.0 - 2026-08-05

### Changed
Expand Down
59 changes: 49 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

**Community skills for better UiPath automation**

UiPath Boost v0.2 gives you 34 Agent Skills for planning, designing, testing, releasing, operating, and explaining UiPath automations. Install the full catalog once, then use `uipath-project-router` to choose the smallest correct workflow for each job.
UiPath Boost v0.3 gives you 35 Agent Skills for planning, designing, visualizing, testing, releasing, operating, and explaining UiPath automations. Install the full catalog once, then use `uipath-project-router` to choose the smallest correct workflow for each job.

> [!IMPORTANT]
> UiPath Boost is an independent community project maintained by [1aifanatic](https://github.com/1aifanatic). It is not an official UiPath product or skill catalog. Official UiPath skills remain the source of truth for product commands, schemas, validation, deployment, tenant operations, and current platform behavior.
Expand All @@ -16,7 +16,7 @@ npm install -g @uipath/cli
uip skills install
```

### 2. Install all 34 UiPath Boost skills
### 2. Install all 35 UiPath Boost skills

> [!TIP]
> **Recommended:** Install the complete catalog globally. You will not need to return later and install skills one at a time.
Expand All @@ -27,7 +27,7 @@ npx skills add 1aifanatic/uipath-boost --skill '*' --agent codex --global --yes

That single command:

- Installs all 34 skills.
- Installs all 35 skills.
- Makes them available across your projects.
- Gives the Project Router every available workflow to choose from.
- Avoids repeated installation whenever your work moves from discovery to development, testing, release, or support.
Expand All @@ -47,31 +47,68 @@ Tell me the smallest correct sequence of official UiPath and UiPath Boost skills
Do not modify files or platform resources while routing.
```

You do not need to memorize all 34 skill names. Describe your goal and let the router select the right starting point.
You do not need to memorize all 35 skill names. Describe your goal and let the router select the right starting point.

## Why install everything at once?

| Benefit | What it means for you |
|---|---|
| One simple setup | Run one installation command instead of managing 34 separate installations. |
| One simple setup | Run one installation command instead of managing 35 separate installations. |
| Better routing | The router can choose from the complete catalog. |
| End-to-end coverage | Move from discovery through delivery, testing, release, and support without stopping to install another skill. |
| Consistent teams | Developers, testers, architects, and support teams can use the same skill set. |
| No automatic platform changes | Installed skills remain instructions until your agent invokes one for a relevant task. |

## How the skills start

Installing the full catalog makes every skill available; it does not run all 34. UiPath Boost uses two clear invocation modes:
Installing the full catalog makes every skill available; it does not run all 35. UiPath Boost uses two clear invocation modes:

| Mode | What happens | Best for |
|---|---|---|
| **User-invoked** | You deliberately name the skill, such as `Use $uipath-project-router`. | Orchestration, durable workspaces, repository setup, and cross-project decisions. |
| **Model-invoked** | You may name the skill, or the agent may select it when your request precisely matches. | Focused engineering disciplines such as component design, regression evidence, observability, or security assessment. |

The 15 user-invoked skills are `uipath-project-router`, `uipath-architecture-deepening`, `uipath-delivery-control-plane`, `uipath-discovery-with-docs`, `uipath-learning-workspace`, `uipath-program-wayfinder`, `uipath-project-handoff`, `uipath-quality-gates-setup`, `uipath-source-control-guardrails`, `uipath-stakeholder-questionnaire`, `uipath-task-refinement`, `uipath-training-lab-scaffolder`, `uipath-uat-session`, `uipath-work-intake-triage`, and `uipath-workflow-spec-workspace`. The other 19 are model-invoked. Codex enforces the split through each skill's `agents/openai.yaml`; explicit-use wording preserves the same intent in other compatible agents.
The 15 user-invoked skills are `uipath-project-router`, `uipath-architecture-deepening`, `uipath-delivery-control-plane`, `uipath-discovery-with-docs`, `uipath-learning-workspace`, `uipath-program-wayfinder`, `uipath-project-handoff`, `uipath-quality-gates-setup`, `uipath-source-control-guardrails`, `uipath-stakeholder-questionnaire`, `uipath-task-refinement`, `uipath-training-lab-scaffolder`, `uipath-uat-session`, `uipath-work-intake-triage`, and `uipath-workflow-spec-workspace`. The other 20 are model-invoked. Codex enforces the split through each skill's `agents/openai.yaml`; explicit-use wording preserves the same intent in other compatible agents.

Invocation never expands authority. A skill still cannot edit source, operate a tenant, deploy, publish, or perform another consequential action unless your request authorizes it and the correct official UiPath owner performs the product work.

## Create a UiPath diagram in three simple steps

The `uipath-diagram-design` skill creates five communication-grade diagram types: solution architecture, process swimlane, interaction sequence, state and lifecycle, and deployment and integration.

### 1. Install it

The recommended full-catalog command above already includes the diagram skill. To install only this skill:

```bash
npx skills add 1aifanatic/uipath-boost --skill uipath-diagram-design --agent codex --global --yes
```

### 2. Describe what the reader should understand

```text
Use $uipath-diagram-design.

Create a UiPath solution architecture from this approved SDD.
Show the business input, UiPath services, queues, robots, human-review path,
external systems, and operational evidence.
Save HTML, SVG, and PNG and inspect the PNG before finishing.
```

You can also ask naturally: `Create a UiPath swimlane from these process notes and highlight the human exception handoff.`

### 3. Use the right output

| Format | Best use |
|---|---|
| HTML | Highest-fidelity browser view |
| SVG | Scalable documentation and editing |
| PNG | GitHub README, presentations, articles, and videos |

![UiPath Diagram Design architecture example](skills/uipath-diagram-design/assets/example-solution-architecture.png)

See the **[simple diagram guide and all five examples](docs/skills/uipath-diagram-design.md)**.

## Why UiPath Boost exists

Official UiPath skills are responsible for current UiPath product behavior. They author and validate product artifacts, operate the platform, troubleshoot failures, and manage product lifecycles.
Expand Down Expand Up @@ -128,7 +165,7 @@ UiPath Boost includes Codex and Claude plugin manifests in addition to the Agent
For detailed explanations, before-and-after examples, prompts, completion checks, and official UiPath handoffs, open the **[complete skill guide library](docs/skills/README.md)** or select any skill below.

<details>
<summary><strong>View all 34 skills by category</strong></summary>
<summary><strong>View all 35 skills by category</strong></summary>

### Routing and project continuity

Expand All @@ -153,6 +190,7 @@ For detailed explanations, before-and-after examples, prompts, completion checks
- [`uipath-component-design`](docs/skills/uipath-component-design.md)
- [`uipath-architecture-deepening`](docs/skills/uipath-architecture-deepening.md)
- [`uipath-project-boundaries`](docs/skills/uipath-project-boundaries.md)
- [`uipath-diagram-design`](docs/skills/uipath-diagram-design.md)
- [`uipath-prototype`](docs/skills/uipath-prototype.md)
- [`uipath-safe-refactor-plan`](docs/skills/uipath-safe-refactor-plan.md)

Expand Down Expand Up @@ -237,20 +275,21 @@ npm test
npm pack --dry-run
```

The validation suite checks all 34 skill packages, invocation policies, behavioral contracts, metadata, internal links, and retired conflicting skills. Installer tests cover interactive, selected-skill, starter, and full-catalog installation arguments.
The validation suite checks all 35 skill packages, invocation policies, behavioral contracts, metadata, internal links, and retired conflicting skills. Installer tests cover interactive, selected-skill, starter, and full-catalog installation arguments.

## Learn more

- [Strategy and publishing plan](docs/STRATEGY-AND-PUBLISHING-PLAN.md)
- [Changelog](CHANGELOG.md)
- [Acknowledgments](ACKNOWLEDGMENTS.md)
- [Third-party licenses](THIRD_PARTY_LICENSES.md)
- [Contribution guide](CONTRIBUTING.md)
- [Security policy](SECURITY.md)
- [Official UiPath skills](https://github.com/UiPath/skills)
- [Agent Skills CLI documentation](https://skills.sh/docs)

## Status and license

UiPath Boost v0.2 is a community release. Structural, behavioral-contract, metadata, link, helper-script, and installer checks protect the catalog, but not every skill has been exercised against every UiPath product, tenant configuration, license, operating system, or future CLI version.
UiPath Boost v0.3 is a community release. Structural, behavioral-contract, metadata, link, helper-script, and installer checks protect the catalog, but not every skill has been exercised against every UiPath product, tenant configuration, license, operating system, or future CLI version.

Licensed under the MIT License. See [LICENSE](LICENSE).
38 changes: 38 additions & 0 deletions THIRD_PARTY_LICENSES.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# Third-Party Licenses

## diagram-design

The `uipath-diagram-design` visual system is a focused adaptation of
[Kathryn Lavery's diagram-design project](https://github.com/cathrynlavery/diagram-design),
reviewed at upstream commit
[`3c5c34ba3bf9dcf204b55c2dd613f8fa194cf584`](https://github.com/cathrynlavery/diagram-design/commit/3c5c34ba3bf9dcf204b55c2dd613f8fa194cf584).

UiPath Boost narrows the general diagram system to five UiPath communication
jobs, introduces UiPath evidence and official-owner boundaries, replaces the
visual tokens with the UiPath Boost community palette and system fonts, adds
UiPath semantic roles, supplies original UiPath-focused examples, and includes
a standard-library exporter with explicit local-browser detection.

### Retained MIT license

MIT License

Copyright (c) 2025 Cathryn Lavery

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
12 changes: 6 additions & 6 deletions docs/STRATEGY-AND-PUBLISHING-PLAN.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,13 @@
- **CLI command:** `uipath-boost`
**Prepared:** July 31, 2026

**Updated for v0.2.0:** August 5, 2026
**Updated for v0.3.0:** August 12, 2026

## 1. Executive recommendation

Use a hybrid ownership strategy:

1. Keep all 34 complementary skills in this independent community repository.
1. Keep all 35 complementary skills in this independent community repository.
2. Treat this repository as the incubator, evidence base, installation source, and educational home.
3. Contribute only mature, broadly useful, UiPath-specific capabilities upstream to `UiPath/skills`.
4. Open one proposal and one pull request at a time rather than submitting the entire catalog.
Expand Down Expand Up @@ -189,7 +189,7 @@ Publishing to skills.sh makes sense for discovery and social proof. skills.sh in
Launch sequence:

1. Publish the GitHub repository publicly.
2. Confirm `npx skills add 1aifanatic/uipath-boost --list` finds 34 skills.
2. Confirm `npx skills add 1aifanatic/uipath-boost --list` finds 35 skills.
3. Perform a clean installation of `uipath-project-router` using the GitHub source.
4. Check for `https://skills.sh/1aifanatic/uipath-boost`.
5. If it is not indexed after valid public installs, open a listing request in `vercel-labs/skills`.
Expand Down Expand Up @@ -344,12 +344,12 @@ Track outcomes rather than only install counts:

- [ ] Confirm repository name and public visibility.
- [ ] Initialize Git and set the default branch to `main`.
- [ ] Review all 34 skills and helper scripts.
- [ ] Review all 35 skills and helper scripts.
- [ ] Confirm the community disclaimer.
- [ ] Confirm license ownership and contributor policy.
- [ ] Configure GitHub security advisories.
- [ ] Run `npm run validate` and `npm test`.
- [ ] Push and tag `v0.2.0`.
- [ ] Push and tag `v0.3.0`.

### npm

Expand All @@ -363,7 +363,7 @@ Track outcomes rather than only install counts:
### skills.sh

- [ ] Verify the GitHub repository is public.
- [ ] Verify standard skill discovery returns all 34 skills.
- [ ] Verify standard skill discovery returns all 35 skills.
- [ ] Install the router through `npx skills add`.
- [ ] Check the canonical skills.sh page.
- [ ] File a listing request if indexing does not occur.
Expand Down
5 changes: 3 additions & 2 deletions docs/skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ This library explains every UiPath Boost skill in practical language. Each guide
- Official UiPath handoffs and safety boundaries.
- Links to the packaged skill, templates, references, and helper scripts.

If you are unsure where to begin, start with the [UiPath Project Router](uipath-project-router.md). You can install all 34 skills once and let the router select the smallest correct workflow for each task.
If you are unsure where to begin, start with the [UiPath Project Router](uipath-project-router.md). You can install all 35 skills once and let the router select the smallest correct workflow for each task.

```bash
npx skills add 1aifanatic/uipath-boost --skill '*' --agent codex --global --yes
Expand All @@ -22,7 +22,7 @@ npx skills add 1aifanatic/uipath-boost --skill '*' --agent codex --global --yes
## Invocation key

- **User-invoked (15):** start these deliberate workflows yourself with `Use $skill-name`. They include Project Router, Architecture Deepening, Delivery Control Plane, Discovery With Docs, Learning Workspace, Program Wayfinder, Project Handoff, Quality Gates Setup, Source Control Guardrails, Stakeholder Questionnaire, Task Refinement, Training Lab Scaffolder, UAT Session, Work Intake Triage, and Workflow Spec Workspace.
- **Model-invoked (19):** name them directly or let the agent choose them when your request precisely matches. Every individual guide shows its mode in the **At a glance** table.
- **Model-invoked (20):** name them directly or let the agent choose them when your request precisely matches. Every individual guide shows its mode in the **At a glance** table.

Installing a skill only makes its instructions available. Invocation does not authorize file changes, tenant operations, deployment, publishing, or other consequential actions.

Expand Down Expand Up @@ -55,6 +55,7 @@ Installing a skill only makes its instructions available. Invocation does not au
| [UiPath Component Design](uipath-component-design.md) | A reusable behavior needs a small stable contract and test seam. | Competing designs, trade-offs, selected contract, and acceptance examples. |
| [UiPath Architecture Deepening](uipath-architecture-deepening.md) | A proven review or incident hotspot needs better seam options. | Change-surface map, ranked options, and safe design handoff. |
| [UiPath Project Boundaries](uipath-project-boundaries.md) | Deep imports, cycles, or private-surface use make changes unsafe. | Boundary policy, automated checks, evidence, and migration plan. |
| [UiPath Diagram Design](uipath-diagram-design.md) | Verified UiPath facts need a crisp architecture, swimlane, sequence, lifecycle, or deployment visual. | Accessible HTML, scalable SVG, reviewed PNG, and evidence status. |
| [UiPath Prototype](uipath-prototype.md) | One design uncertainty can be answered by a small safe experiment. | Throwaway artifact, observed verdict, limitations, and cleanup record. |
| [UiPath Safe Refactor Plan](uipath-safe-refactor-plan.md) | Proven technical debt must improve without changing approved behavior. | Invariants, safety net, tiny steps, rollback, and stop conditions. |

Expand Down
Loading