Skip to content

Commit 1bbe957

Browse files
committed
Name the deployment skill consistently with its siblings
The skill declared 'name: deploy' while living in skills/deployment/. Both resolve, so nothing was broken, but 'deploy' was the only imperative verb among six otherwise nominal skill names (authoring, execution, lookup-files, setup, workflows). Renaming the frontmatter to 'deployment' matches the directory and the authoring/execution pattern, and it also removes a cosmetic quirk where the command picker offered :deploy and rewrote it to :deployment on submit. Changing the frontmatter rather than the directory keeps the diff to 15 lines with no path or CI churn, and follows the nominal naming used throughout foundry-skills as well. Updates the 12 references that named the skill 'deploy' across the README, the orchestrator's routing table, and the sibling skills.
1 parent ac36ce8 commit 1bbe957

6 files changed

Lines changed: 15 additions & 15 deletions

File tree

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -151,7 +151,7 @@ The skills include hooks that ensure the right skills get used:
151151

152152
3. **`PreToolUse` hook (cross-plugin bridge)** — Advisory only. If a request needs a Foundry app (UI, functions, collections, `manifest.yml`), it suggests the sibling [`crowdstrike-falcon-foundry`](https://github.com/CrowdStrike/foundry-skills) plugin. It never blocks a skill.
153153

154-
The `workflows` orchestrator is the entry point: you say what you want, and it routes to `authoring` (discover actions, write and validate YAML), `deploy` (import and release to a CID), and `execution` (trigger and monitor). Hooks observe prompts and tool I/O to keyword-match Fusion actions; no data leaves the session.
154+
The `workflows` orchestrator is the entry point: you say what you want, and it routes to `authoring` (discover actions, write and validate YAML), `deployment` (import and release to a CID), and `execution` (trigger and monitor). Hooks observe prompts and tool I/O to keyword-match Fusion actions; no data leaves the session.
155155

156156
## Skills
157157

@@ -161,7 +161,7 @@ One plugin provides five skills: an orchestrator plus four focused sub-skills.
161161
|-------|---------|
162162
| `workflows` | Primary orchestrator — routes intent and coordinates the full workflow lifecycle |
163163
| `authoring` | Action discovery (`action_search.py`), YAML authoring, CEL expressions, schema validation (`validate.py`) |
164-
| `deploy` | Duplicate check, import to CID, release, version management |
164+
| `deployment` | Duplicate check, import to CID, release, version management |
165165
| `execution` | Trigger workflows with payloads, monitor status, tail logs, debug failures |
166166
| `lookup-files` | Manage Falcon Next-Gen SIEM lookup files (CSV/JSON/TXT) for CQL `match()` queries |
167167

@@ -185,7 +185,7 @@ graph TD
185185
style LF fill:#f59e0b,stroke:#d97706,color:#fff
186186
```
187187

188-
A typical lifecycle: `authoring` produces a validated YAML file → `deploy` imports it and returns a `definition_id``execution` triggers it and returns an `execution_id`. Each phase depends on the previous one's output.
188+
A typical lifecycle: `authoring` produces a validated YAML file → `deployment` imports it and returns a `definition_id``execution` triggers it and returns an `execution_id`. Each phase depends on the previous one's output.
189189

190190
```
191191
skills/

skills/deployment/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
name: deploy
2+
name: deployment
33
description: >
44
Import, release, and manage Falcon Fusion workflow definitions in a CID.
55
TRIGGER when user asks to import a workflow, release a workflow version,

skills/deployment/references/console-verification.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ that, and how to navigate the console reliably to do it.
3434
followed by a blank/partial canvas (0 nodes drawn, Test/Save/Publish locked).
3535
A clean render draws the full graph with **zero** console errors.
3636
4. Delete the test workflow afterward with `delete_workflow.py --id <hex>` (see
37-
the deploy skill) so it doesn't linger in the CID.
37+
the deployment skill) so it doesn't linger in the CID.
3838

3939
The crash above is caused by referencing a node the canvas can't build — most
4040
often a synthetic gateway pass-through. See `workflows/references/yaml-schema.md`

skills/execution/SKILL.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: >
55
TRIGGER when user asks to run a workflow, check execution status, tail logs,
66
get execution results, or debug a workflow failure.
77
DO NOT TRIGGER for writing YAML (use authoring) or importing/releasing
8-
workflows (use deploy).
8+
workflows (use deployment).
99
version: 1.0.0
1010
updated: 2026-06-26
1111
tags: [fusion, soar, workflows, execution, monitoring, debugging]
@@ -49,7 +49,7 @@ An execution moves through states and ends in a **terminal** state. The terminal
4949

5050
Run `/crowdstrike-falcon-fusion:setup` to configure credentials interactively (writes the TOML profile).
5151
- An API client with the **Workflow** API scope
52-
- The **definition ID** of the workflow to run (from the deploy skill's import output, or `query_workflows.py --search`)
52+
- The **definition ID** of the workflow to run (from the deployment skill's import output, or `query_workflows.py --search`)
5353
- Verify auth before running:
5454
```bash
5555
${CLAUDE_PLUGIN_ROOT}/scripts/python.sh common/scripts/auth.py
@@ -65,7 +65,7 @@ A workflow must be enabled before it will execute. Confirm it exists and is enab
6565
${CLAUDE_PLUGIN_ROOT}/scripts/python.sh deployment/scripts/query_workflows.py --search "my workflow"
6666
```
6767

68-
Look for `Status: enabled` in the output. If it shows `disabled`, release it first with the deploy skill (`release_workflow.py --id <id>`).
68+
Look for `Status: enabled` in the output. If it shows `disabled`, release it first with the deployment skill (`release_workflow.py --id <id>`).
6969

7070
### 2. Trigger the workflow with a payload
7171

@@ -155,7 +155,7 @@ Single fetch. Reads `resources[0]` from the API envelope for the execution's `st
155155

156156
## Common Pitfalls
157157

158-
1. **Triggering an unreleased workflow.** A disabled definition will not execute. Confirm `Status: enabled` (step 1) before triggering, and release it via the deploy skill if needed.
158+
1. **Triggering an unreleased workflow.** A disabled definition will not execute. Confirm `Status: enabled` (step 1) before triggering, and release it via the deployment skill if needed.
159159

160160
2. **Missing required parameters.** When triggered via API (not the console UI), parameters are not prompted by the platform. Pass every required field in `--params`. Empty params are the most common failure cause.
161161

skills/lookup-files/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: >
55
TRIGGER when user asks to create, list, update, or delete lookup files,
66
or needs help with CQL match() function.
77
DO NOT TRIGGER for Fusion workflows, action discovery, or workflow deployment —
8-
use the workflows/authoring/deploy skills.
8+
use the workflows/authoring/deployment skills.
99
version: 1.0.0
1010
updated: 2026-06-26
1111
tags: [falcon, ngsiem, siem, lookup-files, cql, threat-hunting]

skills/workflows/SKILL.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ so route based on these criteria without loading sub-skills first.
5050
User wants to write/edit workflow YAML → invoke authoring skill
5151
User wants to find/discover actions → invoke authoring skill
5252
User wants to validate a workflow → invoke authoring skill
53-
User wants to deploy/import/release a workflow → invoke deploy skill
53+
User wants to deploy/import/release a workflow → invoke deployment skill
5454
User wants to run/monitor/debug a workflow → invoke execution skill
5555
User wants full lifecycle (create + deploy + test) → coordinate all three in sequence
5656
User mentions a Foundry app / manifest.yml → advise foundry-skills (see below)
@@ -62,7 +62,7 @@ User mentions lookup files / Next-Gen SIEM → invoke lookup-files skill
6262
| Intent keyword | Sub-skill | What it owns |
6363
|----------------|-----------|--------------|
6464
| "write", "edit", "author", "discover actions", "validate" | **authoring** | Action discovery (`action_search.py`), YAML authoring, CEL, validation (`validate.py`) |
65-
| "deploy", "import", "release", "publish to CID" | **deploy** | Duplicate check, import, release, version management |
65+
| "deploy", "import", "release", "publish to CID" | **deployment** | Duplicate check, import, release, version management |
6666
| "run", "execute", "trigger", "monitor", "tail", "debug" | **execution** | Triggering with payloads, monitoring, logs, results |
6767
| "lookup file", "CSV/JSON lookup", "match() query" | **lookup-files** | Next-Gen SIEM lookup file management |
6868
| "Foundry app", "manifest", "UI + workflow", "functions" | **foundry-skills** (sibling plugin) | App lifecycle, manifest coordination |
@@ -77,7 +77,7 @@ coordinate the three sub-skills in sequence. Do not skip phases.
7777
2. Write the workflow YAML against the schema, with `version_constraint` on every action.
7878
3. Validate with `validate.py` (structural) and, if credentials exist, API validation.
7979

80-
**Step 2 — Deployment** (invoke deploy skill)
80+
**Step 2 — Deployment** (invoke deployment skill)
8181
1. Check for an existing workflow of the same name (`query_workflows.py`) — avoid silent duplicate versions.
8282
2. Import the validated YAML to the CID (`import_workflows.py`).
8383
3. Release the workflow so it becomes executable (`release_workflow.py`).
@@ -114,8 +114,8 @@ User: "Create a Fusion workflow that contains a host on critical detection, then
114114

115115
**After authoring + validating, offer to deploy — don't print a command.** When the user asked to
116116
build a workflow (not "just write the YAML"), and it validates, ASK "Deploy this to your CID now?"
117-
and, on yes, run the deploy yourself via the `deploy` skill. Never tell the user to paste
118-
`/crowdstrike-falcon-fusion:deploy` — invoke it for them. If the workflow contains a
117+
and, on yes, run the deploy yourself via the `deployment` skill. Never tell the user to paste
118+
`/crowdstrike-falcon-fusion:deployment` — invoke it for them. If the workflow contains a
119119
credential-less HTTP Action, after a successful import tell the user it imported (disabled until
120120
released) and give the console steps to attach the API key: open the Cloud HTTP Request action →
121121
Authentication → Create new → API key → secret key → location Header → header name (e.g.

0 commit comments

Comments
 (0)