Skip to content

Commit 4b517aa

Browse files
authored
Release v1.1.0 (#26)
* Release v1.1.0 * Add marketplace description to suppress validation warning * Update release date to 2026-05-13 * Disclose npx swagger2openapi network call in plugin.json * Add foundry-js-sdk.md to ui-development Reading Guide * Rename FalconJS SDK / Foundry-JS SDK to Foundry-JS @crowdstrike/foundry-js is "Foundry-JS", not an SDK. The actual Falcon SDK is @crowdstrike/falconjs. Renamed all references and foundry-js-sdk.md to foundry-js.md per Josh Hiller's review feedback. * Add hook-scope note to README per Anthropic review feedback Clarifies that hooks only keyword-match Foundry-specific actions and no data leaves the session, as requested by bryan-anthropic on PR #1842. * Fix model ID in test scripts to use public alias Changed --model claude-4-6-opus (internal name) to --model opus (public alias per claude --help). The alias stays valid across version bumps. * Pin test scripts to claude-opus-4-6 (correct public model ID)
1 parent 954f5b0 commit 4b517aa

21 files changed

Lines changed: 58 additions & 44 deletions

File tree

.claude-plugin/marketplace.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
{
22
"name": "foundry-marketplace",
3+
"description": "AI coding assistant skills for building CrowdStrike Falcon Foundry apps",
34
"owner": {
45
"name": "CrowdStrike"
56
},
@@ -8,7 +9,7 @@
89
"name": "crowdstrike-falcon-foundry",
910
"source": "./",
1011
"description": "CrowdStrike Falcon Foundry development skills for building cybersecurity applications on the Falcon platform. Includes UI development, collections, functions, workflows, API integration, security patterns, and debugging workflows.",
11-
"version": "1.0.0",
12+
"version": "1.1.0",
1213
"author": {
1314
"name": "CrowdStrike"
1415
},

.claude-plugin/plugin.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "crowdstrike-falcon-foundry",
3-
"description": "CrowdStrike Falcon Foundry development skills for building cybersecurity applications on the Falcon platform. Includes UI development, collections, functions, workflows, API integration, security patterns, and debugging workflows.",
4-
"version": "1.0.0",
3+
"description": "CrowdStrike Falcon Foundry development skills for building cybersecurity applications on the Falcon platform. Includes UI development, collections, functions, workflows, API integration, security patterns, and debugging workflows. Swagger 2.0 specs are auto-converted to OpenAPI 3.0 via npx swagger2openapi (requires Node.js; network call to npm registry).",
4+
"version": "1.1.0",
55
"author": {
66
"name": "CrowdStrike"
77
},

CHANGELOG.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,20 @@ All notable changes to this project will be documented in this file.
44

55
The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
66

7-
## [1.1.0] - TBD
7+
## [1.1.0] - 2026-05-13
88

99
### Added
1010

1111
- **e2e-testing skill** — End-to-end testing for Foundry apps using `@crowdstrike/foundry-playwright`. Covers the 4-project pipeline (authenticate → install → test → uninstall), page objects, configuration screens, custom page objects, CI with GitHub Actions, and debugging with Playwright MCP.
1212
- **NGSIEM query export use case** — Export Falcon Next-Gen SIEM query results to CSV/JSON via Foundry functions with pagination and scheduled workflow patterns.
13-
- **Foundry-JS SDK reference**`falcon.api.workflows`, `falcon.logscale`, `falcon.cloudFunction`, and collections CRUD patterns for `@crowdstrike/foundry-js` in `ui-development/references/foundry-js-sdk.md`.
13+
- **Foundry-JS reference**`falcon.api.workflows`, `falcon.logscale`, `falcon.cloudFunction`, and collections CRUD patterns for `@crowdstrike/foundry-js` in `ui-development/references/foundry-js.md`.
1414
- **Visual debugging section** in debugging-workflows — Screenshot-based troubleshooting with Playwright MCP and test failure artifacts.
1515
- **agentskills.io metadata** — All skills now have top-level `tags`, `author`, `license`, and `compatibility` fields per the [agentskills.io](https://agentskills.io) open spec.
1616

1717
### Changed
1818

1919
- **development-workflow** — Expanded e2e testing guidance with credential configuration details, non-SSO user requirement, and app name alignment.
20+
- **release.sh** — Added Step 8 documenting the Anthropic Plugin Marketplace update process (notify Anthropic of tag + SHA after each release).
2021

2122
### Removed
2223

@@ -33,7 +34,7 @@ Initial public release of Falcon Foundry Skills — AI coding assistant skills f
3334
- **collections-development** — Design and implement Foundry collections with JSON Schema modeling, CRUD operations via CustomStorage, and access control patterns.
3435
- **functions-development** — Build serverless functions in Python or Go with FDK handler patterns, dependency management, and testing.
3536
- **functions-falcon-api** — Call CrowdStrike Falcon APIs from within Foundry functions using zero-argument FalconPy authentication.
36-
- **ui-development** — Build UI pages and extensions with React, Vue, or vanilla JS. Includes FalconJS SDK patterns, Shoelace theming, and iframe communication.
37+
- **ui-development** — Build UI pages and extensions with React, Vue, or vanilla JS. Includes Foundry-JS patterns, Shoelace theming, and iframe communication.
3738
- **workflows-development** — Design Falcon Fusion SOAR workflows with YAML specs, CEL expressions, loop/condition control flow, and platform action integration.
3839
- **debugging-workflows** — Systematic troubleshooting for CLI errors, deployment failures, blank pages, and runtime issues.
3940
- **security-patterns** — OAuth scoping, input validation, XSS prevention, CSP configuration, and secure coding patterns.

README.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# Falcon Foundry Skills
44

5-
![Version](https://img.shields.io/badge/version-1.0.0-blue)
5+
![Version](https://img.shields.io/badge/version-1.1.0-blue)
66
[![CI](https://github.com/CrowdStrike/foundry-skills/actions/workflows/main.yml/badge.svg)](https://github.com/CrowdStrike/foundry-skills/actions/workflows/main.yml)
77

88
AI coding assistant skills for building [CrowdStrike Falcon Foundry](https://www.crowdstrike.com/en-us/platform/next-gen-siem/falcon-foundry/) apps. Build Foundry apps from a natural language prompt — API integrations, workflows, UI pages, functions, and collections — all scaffolded with the Foundry CLI and deployed to the Falcon console.
@@ -133,6 +133,8 @@ The skills include hooks that ensure the right skills get used:
133133

134134
3. **`PreToolUse` hook (CLI guard)** — Validates all Bash commands to ensure Foundry CLI commands include `--no-prompt` flag (prevents `Error: EOF` failures) and blocks manual directory creation for app structure (prevents invalid `manifest.yml`). This enforcement is automatic and transparent — you'll only see it when it catches an error.
135135

136+
Hooks observe prompts and tool I/O to keyword-match Foundry-specific actions; no data leaves the session.
137+
136138
## Skills
137139

138140
| Skill | Purpose |
@@ -334,6 +336,8 @@ gh release create v<version> --target main --title "v<version>" --generate-notes
334336

335337
This generates release notes from merged PRs and saves them as a draft. Review and edit the notes at [github.com/CrowdStrike/foundry-skills/releases](https://github.com/CrowdStrike/foundry-skills/releases), then click **Publish** when ready.
336338

339+
After publishing the release, notify Anthropic of the new tag and SHA so they can update the marketplace pin. Do not open PRs to `anthropics/claude-plugins-official` or re-submit through the plugin submission form.
340+
337341
## License
338342

339343
See [LICENSE](LICENSE) for details.

release.sh

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -185,7 +185,7 @@ main() {
185185
printf "\n${BLUE}Step 5: Commit and create PR${RESET}\n"
186186
local release_branch="release/v${NEXT_VERSION}"
187187
git checkout -b "$release_branch"
188-
git add "$PLUGIN_JSON" "$MARKETPLACE_JSON" "$SCRIPT_DIR/README.md" "$SCRIPT_DIR/skills"/*/SKILL.md "$SCRIPT_DIR/CHANGELOG.md"
188+
git add "$PLUGIN_JSON" "$MARKETPLACE_JSON" "$SCRIPT_DIR/README.md" "$SCRIPT_DIR/skills"/*/SKILL.md "$SCRIPT_DIR/CHANGELOG.md" "$SCRIPT_DIR/release.sh"
189189
git commit -m "Release v${NEXT_VERSION}"
190190
printf "${GREEN}${RESET} Committed v${NEXT_VERSION}\n"
191191

@@ -201,6 +201,13 @@ main() {
201201
printf "This creates a draft release with auto-generated notes from merged PRs.\n"
202202
printf "Review and edit the notes at https://github.com/CrowdStrike/foundry-skills/releases,\n"
203203
printf "then click Publish when ready.\n\n"
204+
205+
printf "${BLUE}Step 8: Update Anthropic Plugin Marketplace${RESET}\n"
206+
printf "\nAfter publishing the GitHub release, notify Anthropic of the new tag and SHA:\n"
207+
printf " Tag: v${NEXT_VERSION}\n"
208+
printf " SHA: \$(git rev-parse v${NEXT_VERSION})\n\n"
209+
printf "Anthropic handles the marketplace pin bump internally. Do not open PRs to\n"
210+
printf "anthropics/claude-plugins-official or re-submit through the plugin submission form.\n\n"
204211
printf "${GREEN}Done.${RESET}\n"
205212
}
206213

skills/api-integrations/SKILL.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
name: api-integrations
33
description: Expose external APIs to Falcon Foundry via OpenAPI specs. TRIGGER when user asks to "create an API integration", "adapt an OpenAPI spec for Foundry", "expose an API to workflows", "connect to a third-party API", or runs `foundry api-integrations create`. Also trigger when user has an OpenAPI/Swagger spec and wants it working in Falcon Foundry. DO NOT TRIGGER when user wants to call Falcon platform APIs from function code — use functions-falcon-api instead.
4-
version: 1.0.0
5-
updated: 2026-04-29
4+
version: 1.1.0
5+
updated: 2026-05-13
66
tags: [foundry, openapi, api, workflows]
77
author: CrowdStrike
88
license: MIT
@@ -151,7 +151,7 @@ For autocomplete dropdown patterns and the HTTP Actions vs. Functions decision f
151151

152152
## Calling API Integrations
153153

154-
UI extensions call API integrations through the Falcon JS SDK (sandboxed iframes block arbitrary HTTP requests). This pattern is from [foundry-sample-foundryjs-demo](https://github.com/CrowdStrike/foundry-sample-foundryjs-demo):
154+
UI extensions call API integrations through Foundry-JS (sandboxed iframes block arbitrary HTTP requests). This pattern is from [foundry-sample-foundryjs-demo](https://github.com/CrowdStrike/foundry-sample-foundryjs-demo):
155155

156156
```javascript
157157
import FalconApi from '@crowdstrike/foundry-js';

skills/api-integrations/references/calling-patterns.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22

33
Full examples for calling API integrations from UI extensions, Python functions, and Go functions.
44

5-
## UI Extensions (JavaScript / Falcon JS SDK)
5+
## UI Extensions (JavaScript / Foundry-JS)
66

77
UI extensions call API integrations through `falcon.apiIntegration()`, not direct HTTP calls. Foundry UI extensions run in sandboxed iframes and cannot make arbitrary HTTP requests.
88

99
```javascript
10-
// React example using Falcon JS SDK
10+
// React example using Foundry-JS
1111
import FalconApi from '@crowdstrike/foundry-js';
1212

1313
const falcon = new FalconApi();

skills/collections-development/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
name: collections-development
33
description: Design JSON Schema collections and CRUD patterns for Falcon Foundry apps. TRIGGER when user asks to "create a collection", "define a JSON schema", "store data in Foundry", runs `foundry collections create`, or needs help with indexable fields, FQL queries, or collection access patterns. DO NOT TRIGGER for workflow YAML, function handlers, or UI components — use the appropriate sub-skill.
4-
version: 1.0.0
5-
updated: 2026-04-29
4+
version: 1.1.0
5+
updated: 2026-05-13
66
tags: [foundry, collections, json-schema, nosql]
77
author: CrowdStrike
88
license: MIT

skills/debugging-workflows/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
name: debugging-workflows
33
description: Systematic troubleshooting for Falcon Foundry CLI errors, manifest validation failures, deploy failures, and development server issues. TRIGGER when user encounters CLI errors, `foundry ui run` not working, deploy failures, authentication issues, or any unexpected behavior during Foundry app development. Also trigger for headless/CI environment setup failures.
4-
version: 1.0.0
5-
updated: 2026-04-29
4+
version: 1.1.0
5+
updated: 2026-05-13
66
tags: [foundry, debugging, cli, deployment]
77
author: CrowdStrike
88
license: MIT

skills/development-workflow/SKILL.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
name: development-workflow
33
description: Orchestrates the complete Falcon Foundry app lifecycle from requirements through deployment. TRIGGER when user asks to "create a Foundry app", "build a Foundry app", "plan a Foundry app", runs any `foundry apps` CLI command, or discusses Foundry app architecture. DO NOT TRIGGER when user is working on a specific capability (UI, function, workflow, collection) within an existing app — use the appropriate sub-skill instead. This skill OWNS the entire Foundry development flow. Do not delegate Foundry app creation to superpowers:brainstorming or superpowers:writing-plans — those skills do not know about the Foundry CLI.
4-
version: 1.0.0
5-
updated: 2026-04-29
4+
version: 1.1.0
5+
updated: 2026-05-13
66
tags: [foundry, lifecycle, cli, deployment]
77
author: CrowdStrike
88
license: MIT

0 commit comments

Comments
 (0)