Skip to content

Commit 8964502

Browse files
committed
Add foundry-redirect skill so the Foundry-app redirect works without hooks
The workflows orchestrator declines Falcon Foundry app requests (UI, functions, collections, manifest.yml, custom third-party API integrations), but that instruction lives in a skill whose description matches Fusion-workflow language — so a 'build a Foundry app' prompt never loads the orchestrator and never reads the redirect. On Claude Code the fusion-foundry-bridge hook covers the gap; hooks do not fire in Codex, Copilot CLI, Cursor, or the Agent SDK, so for those the redirect is structurally unreachable. This adds skills/foundry-redirect/SKILL.md whose description matches Foundry-app language directly, so the redirect is reachable on every assistant. It declines the request and points to the crowdstrike-falcon-foundry plugin, and yields to that plugin's own development-workflow skill (stronger match) when it is installed. Mirrors the fusion-redirect skill foundry-skills added for the reverse direction. README skills table and CHANGELOG updated. Frontmatter/version-consistency/size-budget/ markdownlint all pass.
1 parent 97dbd29 commit 8964502

3 files changed

Lines changed: 58 additions & 1 deletion

File tree

CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
88

99
### Added
1010

11+
- **`foundry-redirect` skill** — declines Falcon Foundry app requests (a UI page, serverless function, collection, `manifest.yml`, or custom third-party API integration) and points to the sibling `crowdstrike-falcon-foundry` plugin. The `workflows` orchestrator already declines these, but its description matches Fusion-workflow language, so a "build a Foundry app" prompt never loads it; a Claude Code hook covered that gap, but hooks do not fire in Codex, Copilot CLI, Cursor, or the Agent SDK. This skill's description matches Foundry-app language directly, so the redirect is reachable on every assistant. It yields to the Foundry plugin's own skill when that plugin is installed.
1112
- US-3 cloud region to credential setup: a `[us-3]` profile example (`https://api.us-3.crowdstrike.com`) in the setup skill's multi-cloud block and in the README region notes, alongside a `[us-gov-1]` example that was also missing. The auth module already accepts any `base_url`, so this documents the host rather than changing behavior.
1213
- Throttling reference in the execution skill: explains that a workflow stuck "in progress" may be throttled (Fusion paces an action past a volume limit, auto-retrying up to 6 hours) rather than failed, how to recognize it on the execution detail view, and when sustained throttling signals a workflow-design issue.
1314
- Deduplicate and Rate Limit action reference plus a worked tutorial example. Covers all six Deduplicate activities and all four Rate Limit activities: the `definition`/`cid` scope values (which the console labels "Workflow" and "CID"), the atomic claim, metadata handoff, and the save-time validation the builder runs. The example deduplicates third-party NG-SIEM detections into a single case. Action IDs were confirmed against a live tenant; the example passes validation at all tiers.

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -156,7 +156,7 @@ The `workflows` orchestrator is the entry point: you say what you want, and it r
156156

157157
## Skills
158158

159-
One plugin provides five skills: an orchestrator plus four focused sub-skills.
159+
One plugin provides six skills: an orchestrator, four focused sub-skills, and a Foundry-app redirect.
160160

161161
| Skill | Purpose |
162162
|-------|---------|
@@ -165,6 +165,7 @@ One plugin provides five skills: an orchestrator plus four focused sub-skills.
165165
| `deployment` | Duplicate check, import to CID, release, version management |
166166
| `execution` | Trigger workflows with payloads, monitor status, tail logs, debug failures |
167167
| `lookup-files` | Manage Falcon Next-Gen SIEM lookup files (CSV/JSON/TXT) for CQL `match()` queries |
168+
| `foundry-redirect` | Declines Falcon Foundry app requests (UI, functions, collections, `manifest.yml`) and points to the `crowdstrike-falcon-foundry` plugin |
168169

169170
### Architecture
170171

skills/foundry-redirect/SKILL.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
name: foundry-redirect
3+
description: >
4+
TRIGGER when the user asks to "build a Foundry app", "create a Foundry app",
5+
mentions manifest.yml, or needs a UI page/extension, serverless function,
6+
collection, or a custom API integration from a third-party API (Okta, ServiceNow,
7+
Jira, etc.) built. DO NOT TRIGGER for a standalone Fusion workflow that only wires
8+
together existing actions. This skill declines Foundry-app requests and points to
9+
the crowdstrike-falcon-foundry plugin, so the redirect works even without Claude
10+
Code hooks; it yields to the real Foundry plugin when that plugin is also installed.
11+
version: 1.0.1
12+
updated: 2026-08-17
13+
tags: [fusion, foundry, redirect, routing]
14+
author: CrowdStrike
15+
license: MIT
16+
compatibility: Claude Code >=1.0
17+
metadata:
18+
category: routing
19+
---
20+
21+
# Falcon Foundry Redirect
22+
23+
If this skill triggered, the request is a **Falcon Foundry app**, not a standalone
24+
Falcon Fusion workflow. It belongs to the sibling Falcon Foundry plugin — the
25+
`fusion-skills` plugin builds Fusion workflows only.
26+
27+
Why this skill exists: the `workflows` orchestrator declines Foundry-app requests too,
28+
but its description matches *Fusion workflow* language, so a "build a Foundry app"
29+
prompt never loads it. On Claude Code a hook covers that gap; on Codex, Copilot CLI,
30+
Cursor, and the Agent SDK there are no hooks, so this skill — whose description matches
31+
Foundry-app language directly — is what makes the redirect reachable.
32+
33+
## What to do
34+
35+
Do NOT author workflow YAML. Do NOT scaffold an app yourself. Respond with all three:
36+
37+
1. State plainly that this request needs a Falcon Foundry app, not a standalone Fusion workflow.
38+
2. Name the plugin: **`crowdstrike-falcon-foundry`**.
39+
3. How to install it: `/plugin install crowdstrike-falcon-foundry`, or clone https://github.com/CrowdStrike/foundry-skills.
40+
41+
## When both plugins are installed
42+
43+
If `crowdstrike-falcon-foundry` is present, its own `development-workflow` skill matches
44+
Foundry-app requests directly and handles them — a stronger match than this one, so the
45+
agent picks it and this redirect never fires. That is correct: this skill is the safety
46+
net for when the Foundry plugin is absent, not a competitor with it when present.
47+
48+
## Foundry app vs. standalone workflow
49+
50+
| Signal in the request | Route |
51+
|---|---|
52+
| "Foundry app", `manifest.yml`, a UI page/extension, serverless function, collection, or custom third-party API integration | **Here** — redirect to foundry-skills |
53+
| A trigger plus existing Fusion actions only (no UI, function, collection, or custom integration) | **`workflows`** — handle it as a standalone workflow |
54+
| "a workflow inside a Foundry app" | **Here** — the app owns the workflow; Foundry scaffolds it |
55+
| Fetch/summarize a population of alerts/detections the workflow doesn't already hold | **`workflows`** — a standalone CrowdStrike HTTP Request handles this without an app |

0 commit comments

Comments
 (0)