Skip to content

Commit e98264b

Browse files
committed
Add CrowdStrike logo, Codex/Copilot CLI sections, and broaden pre-flight check
Add the standard CrowdStrike Falcon logo to the top of the README. Add Codex and Copilot CLI setup sections using ~/.agents/skills/ symlink discovery (sourced from official docs). Reorder tool sections alphabetically. Broaden the A/B test pre-flight check to compare all plugin directories instead of a single canary file.
1 parent faab429 commit e98264b

2 files changed

Lines changed: 53 additions & 17 deletions

File tree

README.md

Lines changed: 27 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
![CrowdStrike Falcon](/images/cs-logo.png?raw=true)
2+
13
# Falcon Foundry Skills
24

35
![Version](https://img.shields.io/badge/version-1.0.0-blue)
@@ -12,7 +14,7 @@ AI coding assistant skills for building [CrowdStrike Falcon Foundry](https://www
1214
- **Foundry CLI**: Install with `brew tap crowdstrike/foundry-cli && brew install foundry` (macOS/Linux) or [download for Windows](https://assets.foundry.crowdstrike.com/cli/latest/foundry_Windows_x86_64.zip)
1315
- **CrowdStrike Account**: With Falcon Foundry access
1416
- **Authentication**: Run `foundry login` to authenticate
15-
- **AI Coding Assistant**: Claude Code, Cursor, Gemini CLI, Codex, OpenCode, Copilot CLI, or any tool that supports loading reference documentation
17+
- **AI Coding Assistant**: Claude Code, Codex, Copilot CLI, Cursor, Gemini CLI, or any tool that supports loading reference documentation
1618

1719
### Claude Code (Tested)
1820

@@ -39,6 +41,30 @@ The `--plugin-dir` flag loads the plugin for that session. To make it permanent,
3941

4042
Changes to skill files take effect on the next Claude Code session — no reinstall needed.
4143

44+
### Codex (Experimental)
45+
46+
Codex discovers skills from `~/.agents/skills/`. Clone and symlink:
47+
48+
```bash
49+
git clone https://github.com/CrowdStrike/foundry-skills.git
50+
mkdir -p ~/.agents/skills
51+
ln -s /path/to/foundry-skills/skills ~/.agents/skills/foundry-skills
52+
```
53+
54+
Restart Codex to discover the skills. See the [Codex skills docs](https://developers.openai.com/codex/skills) for details.
55+
56+
### Copilot CLI (Experimental)
57+
58+
Copilot CLI shares the `~/.agents/skills/` discovery directory with Codex:
59+
60+
```bash
61+
git clone https://github.com/CrowdStrike/foundry-skills.git
62+
mkdir -p ~/.agents/skills
63+
ln -s /path/to/foundry-skills/skills ~/.agents/skills/foundry-skills
64+
```
65+
66+
Restart Copilot CLI to discover the skills.
67+
4268
### Cursor (Experimental)
4369

4470
Add a rule file to your project's `.cursor/rules/` directory:
@@ -72,16 +98,6 @@ This creates symlinks in `~/.gemini/skills/` so all skills are available in ever
7298

7399
Gemini activates the right skill on demand based on your prompt. No `GEMINI.md` changes needed.
74100

75-
### Codex (Experimental)
76-
77-
Add to your `AGENTS.md` or project instructions:
78-
79-
```markdown
80-
## Foundry Development
81-
Reference the Falcon Foundry skills in /path/to/foundry-skills/skills/ for building Foundry apps.
82-
The primary orchestrator is foundry-development-workflow/SKILL.md.
83-
```
84-
85101
### Other Tools
86102

87103
These skills are plain markdown files. Any AI coding assistant that can read local files can use them. Point it at the `skills/` directory and start with `foundry-development-workflow/SKILL.md` as the entry point.

run-ab-test.sh

Lines changed: 26 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -173,20 +173,40 @@ if [ "$NO_SKILL" != "1" ]; then
173173
git -C "$REPO_ROOT" archive "$BASELINE_REF" | tar -x -C "$MAIN_EXTRACT_DIR"
174174
fi
175175

176-
if diff -q "$MAIN_EXTRACT_DIR/skills/foundry-workflows-development/SKILL.md" \
177-
"$REPO_ROOT/skills/foundry-workflows-development/SKILL.md" >/dev/null 2>&1; then
178-
echo "ERROR: Local skills are identical to main branch."
176+
PREFLIGHT_DIFF=0
177+
for dir in skills hooks use-cases; do
178+
if [ -d "$MAIN_EXTRACT_DIR/$dir" ] || [ -d "$REPO_ROOT/$dir" ]; then
179+
if ! diff -rq "$MAIN_EXTRACT_DIR/$dir" "$REPO_ROOT/$dir" >/dev/null 2>&1; then
180+
PREFLIGHT_DIFF=1
181+
break
182+
fi
183+
fi
184+
done
185+
# Also check top-level files that affect plugin behavior
186+
for f in CLAUDE.md hooks.json; do
187+
if [ -f "$MAIN_EXTRACT_DIR/$f" ] || [ -f "$REPO_ROOT/$f" ]; then
188+
if ! diff -q "$MAIN_EXTRACT_DIR/$f" "$REPO_ROOT/$f" >/dev/null 2>&1; then
189+
PREFLIGHT_DIFF=1
190+
break
191+
fi
192+
fi
193+
done
194+
if [ "$PREFLIGHT_DIFF" = "0" ]; then
195+
echo "ERROR: Local plugin files are identical to $BASELINE_REF."
179196
echo ""
180197
echo " The A/B test compares baseline ref ($BASELINE_REF) skills (RED) vs local skills (GREEN)."
181198
echo " If they're the same, the test is meaningless."
182199
echo ""
200+
echo " Directories checked: skills/, hooks/, use-cases/"
201+
echo " Files checked: CLAUDE.md, hooks.json"
202+
echo ""
183203
echo " Common causes:"
184-
echo " - Working tree was reset to $BASELINE_REF"
185-
echo " - Branch has no skill changes"
204+
echo " - Working tree was reset to $BASELINE_REF"
205+
echo " - Branch has no skill/hook changes"
186206
echo ""
187207
exit 1
188208
fi
189-
echo "Pre-flight: local skills differ from $BASELINE_REF. Good."
209+
echo "Pre-flight: local plugin files differ from $BASELINE_REF. Good."
190210
echo ""
191211
fi
192212

0 commit comments

Comments
 (0)