### Dependency Graph Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/plan.md

Illustrates the dependency structure of project components, guiding a bottom-up build approach with vertical slices.

```text
[
schema changes]
        │
        ├─▶ [domain types]
        │         │
        │         ├─▶ [API endpoints]
        │         │         │
        │         │         └─▶ [client calls]
        │         │                   │
        │         │                   └─▶ [UI components]
        │         │
        │         └─▶ [validation]
        │
        └─▶ [seed / migration scripts]

```

--------------------------------

### Build Command Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/plan.md

Example of a command to build the project, used for verification in the task list.

```bash
<build command>
```

--------------------------------

### Install Command

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/spec.md

Use this command to install project dependencies.

```bash
# Install
[install command]
```

--------------------------------

### Install Lich Skills via OpenAI Codex CLI

Source: https://github.com/lichamnesia/lich-skills/blob/main/README.md

This guide provides instructions for installing the Lich Skills collection for use with the OpenAI Codex CLI. It involves installing the CLI tool and then cloning the skills repository into the appropriate directory.

```bash
# 1. Install Codex CLI
npm install -g @openai/codex
# or: brew install --cask codex
```

```bash
# 2. Install the skill collection
mkdir -p ~/.codex/skills
git clone https://github.com/LichAmnesia/lich-skills.git ~/.codex/skills/lich-skills
```

--------------------------------

### Install Gemini CLI with npx

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/gemini-cli-setup.md

Installs and runs the Gemini CLI without a global installation using npx.

```bash
npx @google/gemini-cli
```

--------------------------------

### Install Gemini CLI with npm

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/gemini-cli-setup.md

Installs the Gemini CLI globally using npm. Requires Node.js 20+.

```bash
npm install -g @google/gemini-cli
```

--------------------------------

### Development Command

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/spec.md

Command to start the development server.

```bash
# Dev
[dev command]
```

--------------------------------

### Project Structure Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/spec.md

Illustrates a typical project directory structure for an application.

```text
src/            → application source
src/components  → reusable UI
src/lib         → shared utilities
src/server      → server-only code
tests/          → unit tests, mirrors src/
e2e/            → end-to-end tests
docs/           → documentation
```

--------------------------------

### Test Command Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/plan.md

Example of a command to verify task completion, typically used in the 'Verify' section of a task.

```bash
<test command>
```

--------------------------------

### Install lich-skills Extension (One-line)

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/gemini-cli-setup.md

Installs the lich-skills extension using a single command. The CLI clones the repository and reads the manifest automatically.

```bash
gemini extensions install https://github.com/LichAmnesia/lich-skills
```

--------------------------------

### Verify Gemini CLI Installation

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/gemini-cli-setup.md

Checks the installed version of the Gemini CLI. The first run will prompt for authentication.

```bash
gemini --version
```

--------------------------------

### Verify lich-skills Extension Installation

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/gemini-cli-setup.md

Lists all installed Gemini CLI extensions to confirm that lich-skills is included.

```bash
gemini extensions list
```

--------------------------------

### Install uv Package Manager

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/nano-banana/SKILL.md

Install uv, a fast Python package installer, if it is not already present on your system. This is used for managing Python dependencies.

```bash
command -v uv || curl -LsSf https://astral.sh/uv/install.sh | sh
```

--------------------------------

### Install Lich Skills for OpenAI Codex CLI

Source: https://context7.com/lichamnesia/lich-skills/llms.txt

Install Lich Skills for use with the OpenAI Codex CLI by cloning the repository into the Codex skills directory. This setup is for users of the Codex CLI.

```bash
npm install -g @openai/codex

mkdir -p ~/.codex/skills
git clone https://github.com/LichAmnesia/lich-skills.git ~/.codex/skills/lich-skills
```

--------------------------------

### Install lich-skills Collection (Per-Project)

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/claude-code-setup.md

Clone the lich-skills collection into a project-specific directory. Remember to add the directory to your .gitignore if you do not want to vendor it.

```bash
cd /path/to/your/project
mkdir -p .claude/skills
git clone https://github.com/LichAmnesia/lich-skills.git .claude/skills/lich-skills
```

--------------------------------

### Subagent Prompting: Good Example

Source: https://context7.com/lichamnesia/lich-skills/llms.txt

This approach is more efficient for subagent prompts, as it involves a single read call for necessary files.

```shell
# GOOD — one Read call inside the subagent is cheaper:
# "Read src/middleware/rateLimit.ts and report the public API surface."
```

--------------------------------

### Per-Project lich-skills Installation

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/codex-setup.md

Installs the lich-skills collection within a specific project's directory. This allows for project-specific skill sets, which can be committed or ignored.

```bash
cd /path/to/your/project
mkdir -p .codex/skills
git clone https://github.com/LichAmnesia/lich-skills.git .codex/skills/lich-skills
```

--------------------------------

### Task Sizing Table Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/plan.md

Reference table for estimating task sizes based on the number of files and scope of work.

```markdown
| Size | Files | Scope |
|---|---|---|
| XS | 1 | Config or single rule change |
| S | 1–2 | One endpoint, one component |
| M | 3–5 | One vertical feature slice |
| L | 5–8 | Split if possible |
| XL | 8+ | **Too big. Break it down.** |
```

--------------------------------

### Install Codex CLI with Homebrew

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/codex-setup.md

Installs the OpenAI Codex CLI using Homebrew on macOS or Linux.

```bash
brew install --cask codex
```

--------------------------------

### Install Claude Code (Native Installer - macOS/Linux/WSL)

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/claude-code-setup.md

Use this command to install Claude Code using the native installer on macOS, Linux, or WSL. This method supports automatic background updates.

```bash
curl -fsSL https://claude.ai/install.sh | bash
```

--------------------------------

### Install lich-skills Extension (Per-Project)

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/gemini-cli-setup.md

Clones the lich-skills extension into a project's local .gemini/extensions directory for project-scoped usage.

```bash
cd /path/to/your/project
mkdir -p .gemini/extensions
git clone https://github.com/LichAmnesia/lich-skills.git .gemini/extensions/lich-skills
```

--------------------------------

### Install Lich Skills via Gemini CLI Extensions

Source: https://github.com/lichamnesia/lich-skills/blob/main/README.md

Use the Gemini CLI's native extensions command to install Lich Skills directly from its GitHub repository. This method leverages the `gemini-extension.json` manifest for automatic discovery. A manual clone option is also provided.

```bash
gemini extensions install https://github.com/LichAmnesia/lich-skills
```

```bash
gemini extensions list
```

```bash
npm install -g @google/gemini-cli
git clone https://github.com/LichAmnesia/lich-skills.git ~/.gemini/extensions/lich-skills
```

--------------------------------

### TypeScript Code Style Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/spec.md

Demonstrates naming conventions, formatting, error handling, and imports in TypeScript.

```typescript
// Naming, formatting, error handling, imports — demonstrated:
export async function getTaskById(id: TaskId): Promise<Task | null> {
  const row = await db.tasks.findUnique({ where: { id } });
  return row ? toTask(row) : null;
}
```

--------------------------------

### Fast Checks for Nano Banana Setup

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/nano-banana/SKILL.md

Perform quick checks to ensure that the necessary tools and environment variables are configured correctly before running image generation or editing tasks.

```bash
command -v uv
test -n "$GEMINI_API_KEY" || test -n "$GOOGLE_API_KEY"
# If editing:
test -f ./input.png
```

--------------------------------

### Install Claude Code (Native Installer - Windows PowerShell)

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/claude-code-setup.md

Execute this command in Windows PowerShell to install Claude Code using the native installer. This method also supports automatic background updates.

```powershell
irm https://claude.ai/install.ps1 | iex
```

--------------------------------

### Verify Codex CLI Installation

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/codex-setup.md

Checks if the Codex CLI is installed correctly and displays its version. The first run may trigger authentication.

```bash
codex --version
```

--------------------------------

### Install Codex CLI with npm

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/codex-setup.md

Installs the OpenAI Codex CLI globally using npm. Requires Node.js 20 or later.

```bash
npm install -g @openai/codex
```

--------------------------------

### Replace Context with Summaries Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/subagent-brief/SKILL.md

Instead of pasting large context windows, provide a concise 1-3 sentence summary. This significantly reduces token usage while conveying essential information.

```text
BAD:  <entire 50K context window dump> — now look for X
GOOD: Project context: <3-line summary>. Look for X in <specific path>.
```

--------------------------------

### Subagent Prompting: Bad Example

Source: https://context7.com/lichamnesia/lich-skills/llms.txt

Avoid this approach for subagent prompts as it leads to expensive re-tokenization of large file contents.

```shell
# BAD — costs 800-line re-tokenization per spawn:
# "Here is the full content of src/middleware/rateLimit.ts: <800 lines>"
```

--------------------------------

### Install Lich Skills as a Gemini CLI Extension

Source: https://context7.com/lichamnesia/lich-skills/llms.txt

Install Lich Skills as a first-class Gemini CLI extension using the gemini-extension.json manifest. This method ensures seamless integration with the Gemini CLI.

```bash
# Install extension (auto-discovers all skills)
gemini extensions install https://github.com/LichAmnesia/lich-skills

# Verify
gemini extensions list

# Manual fallback
npm install -g @google/gemini-cli
git clone https://github.com/LichAmnesia/lich-skills.git ~/.gemini/extensions/lich-skills
```

--------------------------------

### Install Lich Skills via Git Clone for Claude Code

Source: https://github.com/lichamnesia/lich-skills/blob/main/README.md

This method involves cloning the repository directly into Claude Code's global skills directory. It's a fallback if the marketplace method is not preferred or available. Ensure Claude Code is installed first.

```bash
# 1. Install Claude Code (if not already)
curl -fsSL https://claude.ai/install.sh | bash
# or: brew install --cask claude-code
```

```bash
# 2. Clone into the global skills directory
git clone https://github.com/LichAmnesia/lich-skills.git ~/.claude/skills/lich-skills
```

```bash
# 3. Start Claude Code
claude
> /skills
```

--------------------------------

### Install lich-skills Extension (Manual Clone)

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/gemini-cli-setup.md

Manually clones the lich-skills extension into the specified directory for local editing or specific branch usage.

```bash
mkdir -p ~/.gemini/extensions
git clone https://github.com/LichAmnesia/lich-skills.git ~/.gemini/extensions/lich-skills
```

--------------------------------

### Install lich-skills Collection (Symlink)

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/claude-code-setup.md

Create a symbolic link to an existing clone of the lich-skills repository into the Claude Code skills directory. This avoids duplicating the repository.

```bash
git clone https://github.com/LichAmnesia/lich-skills.git ~/projects/lich-skills
ln -s ~/projects/lich-skills ~/.claude/skills/lich-skills
```

--------------------------------

### Rollout Plan Steps

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/ship.md

Defines a phased approach for deploying a feature, starting from staging and progressing to a full production rollout with monitoring at each stage.

```text
1. Deploy to staging
   └── Full e2e green, manual smoke test
2. Deploy to production, flag OFF
   └── Health check, error monitor clean for 15min
3. Flag ON for internal team
   └── 24h monitoring window
4. Canary: 5% of users
   └── 24–48h monitoring window
5. 25% → 50% → 100%
   └── Monitor at each step
6. Flag ON globally
   └── 1 week of monitoring, then flag cleanup
```

--------------------------------

### Include lich-skills Directory in GEMINI.md

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/gemini-cli-setup.md

References the lich-skills directory from ~/.gemini/GEMINI.md as persistent context, bypassing automatic extension installation.

```bash
git clone https://github.com/LichAmnesia/lich-skills.git ~/projects/lich-skills
```

```md
# Skills

Refer to the skill definitions under:
`~/projects/lich-skills/skills/`

- spec-driven-dev — full SDLC workflow (Spec → Plan → Build → Test → Review → Ship)
- tavily-search   — web search + extraction via Tavily
- nano-banana     — text-to-image and image edits via Nano Banana 2
```

--------------------------------

### Generate Image with Structured Prompt

Source: https://context7.com/lichamnesia/lich-skills/llms.txt

For best results, use a structured prompt template that specifies subject, style, composition, lighting, background, and elements to avoid. This example also sets the resolution to 2K.

```bash
# Generate with structured prompt template for best results:
uv run "$SCRIPT" \
    --prompt "Subject: red fox sitting on mossy log.
Style: oil painting, impressionist.
Composition: medium shot, eye level.
Lighting: golden hour, soft side light.
Background: blurred forest.
Avoid: cartoon style, harsh shadows." \
    --filename "fox-painting.png" \
    --resolution 2K
```

--------------------------------

### Skill Frontmatter Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/CONTRIBUTING.md

Skills require YAML frontmatter with a name and a one-sentence description. This metadata helps categorize and understand the skill's purpose.

```yaml
---
name: skill-name
description: Use when <trigger condition>. One sentence.
---
```

--------------------------------

### Install lich-skills Collection (Global)

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/claude-code-setup.md

Clone the lich-skills collection into your global skills directory. This makes the skills available to Claude Code in all projects.

```bash
mkdir -p ~/.claude/skills
git clone https://github.com/LichAmnesia/lich-skills.git ~/.claude/skills/lich-skills
```

--------------------------------

### Install Claude Code (npm - Deprecated)

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/claude-code-setup.md

Install Claude Code globally using npm. Requires Node.js 18+ and should not be run with sudo. This method is deprecated but still supported.

```bash
npm install -g @anthropic-ai/claude-code
```

--------------------------------

### Install lich-skills Collection

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/codex-setup.md

Clones the lich-skills repository into the default location for Codex CLI skills. Creates the necessary directory if it doesn't exist.

```bash
mkdir -p ~/.codex/skills
git clone https://github.com/LichAmnesia/lich-skills.git ~/.codex/skills/lich-skills
```

--------------------------------

### Allowed Import Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev-v2/templates/artifact-registry/RULE.md

Demonstrates an allowed import scenario where an L2 module imports from an L0 module.

```typescript
// src/io/http.ts
import { parseTask } from '../core/task';  // L2 → L0, fine
```

--------------------------------

### Edit Image with Nano Banana (Input Image Provided)

Source: https://context7.com/lichamnesia/lich-skills/llms.txt

To edit an existing image, provide the --input-image flag. The resolution will be auto-matched to the input image dimensions. This example removes a crowd from a portrait.

```bash
# Edit — pass --input-image; resolution auto-matched to input dimensions
uv run "$SCRIPT" \
    --prompt "Remove the crowd behind the subject. Keep framing, grading, and lighting unchanged." \
    --filename "portrait-cleaned.png" \
    --input-image "./portrait.png"
```

--------------------------------

### Risk Mitigation Table Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/plan.md

Table for documenting project risks, their impact, likelihood, and proposed mitigation strategies.

```markdown
| Risk | Impact | Likelihood | Mitigation |
|---|---|---|---|
| [e.g. Migration locks table] | High | Low | Run in maintenance window, test on staging dump |
| | | | |
```

--------------------------------

### List Skills in Claude Code Session

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/claude-code-setup.md

Launch Claude Code and use the `/skills` command to list all loaded skills. This verifies that the lich-skills collection has been correctly installed.

```bash
claude
> /skills
```

--------------------------------

### Extract Blog Post to JSON

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/tavily-search/SKILL.md

Example of extracting the full article body from a blog post and saving it as a JSON file.

```bash
uv run .../search.py --extract https://blog.example.com/post --json > post.json
```

--------------------------------

### Skill YAML Frontmatter Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/CLAUDE.md

Skills should use YAML frontmatter to define their name and a one-line trigger description. This format is standard for skill definitions within the repository.

```yaml
---
name: skill-name
description: One-line trigger description starting with "Use when..."
---
```

--------------------------------

### Verification Command Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev-v2/templates/task/TASK.md

Specifies the shell command used to verify the completion of a task. This command should exit with a non-zero status code if the task fails verification.

```bash
<verify command — same as frontmatter `verify`>
```

--------------------------------

### Hypotheses Section Format

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/debug-hypothesis/SKILL.md

Example format for documenting hypotheses in DEBUG.md. Includes supporting evidence, conflicting evidence, and the test for each hypothesis.

```markdown
## Hypotheses


```

--------------------------------

### Install Lich Skills via Claude Code Marketplace

Source: https://github.com/lichamnesia/lich-skills/blob/main/README.md

Use this command within a running Claude Code session to add the Lich Skills collection from the plugin marketplace. This is the quickest way to make all skills available.

```bash
/plugin marketplace add LichAmnesia/lich-skills
```

```bash
/plugin install lich-skills@lich-skills
```

```bash
/skills
```

--------------------------------

### Replace Files with Paths Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/subagent-brief/SKILL.md

When invoking a subagent, replace the full content of a file with its absolute path. The subagent has read access, making this more token-efficient than pasting large amounts of code.

```text
BAD:  Here is the full content of foo.py: <800 lines>
GOOD: Read /abs/path/to/foo.py and report the public API.
```

--------------------------------

### Build Command

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/spec.md

Command to build the project for production.

```bash
# Build
[build command]
```

--------------------------------

### Verify Claude Code Installation

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/claude-code-setup.md

Run these commands to verify your Claude Code installation and perform a deeper health check. Authentication is required after the first run.

```bash
claude --version
```

```bash
claude doctor
```

--------------------------------

### Install Claude Code (Homebrew)

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/claude-code-setup.md

Install Claude Code using Homebrew on macOS or Linux. Note that Homebrew casks do not auto-update; run `brew upgrade claude-code` periodically.

```bash
brew install --cask claude-code
```

--------------------------------

### Development Workflow Commands

Source: https://github.com/lichamnesia/lich-skills/blob/main/CONTRIBUTING.md

This bash script outlines the essential steps for setting up a development environment, creating a new branch, making changes, and submitting a pull request.

```bash
# 1. Fork + clone
git clone https://github.com/<you>/lich-skills.git
cd lich-skills

# 2. Branch
git checkout -b feat/<skill-name>

# 3. Add / edit skill or tool
#    skills/<skill-name>/SKILL.md
#    skills/<skill-name>/scripts/  (if tool-backed)
#    index.js (if tool-backed)
#    package.json (if new dependencies)

# 4. Install dependencies
npm install

# 5. Scan for secrets before pushing
gitleaks detect --no-banner

# 6. Commit (Conventional Commits)
git commit -m "feat(<skill-name>): add <short description>"

# 7. Open PR against main
gh pr create --fill
```

--------------------------------

### Rollback Steps with Commands

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/ship.md

Details the steps for rolling back a feature deployment, including flipping a feature flag, redeploying a previous build, and rolling back database migrations if necessary. Includes target times for each step.

```bash
git revert <commit> && <deploy command>
```

```bash
<rollback command>
```

--------------------------------

### Invoke a Skill Directly in Gemini CLI

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/gemini-cli-setup.md

Example of invoking the tavily-search skill to find specific information.

```bash
> use the tavily-search skill to find the latest Gemini CLI release notes
```

--------------------------------

### Research Gemini API Pricing

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/tavily-search/SKILL.md

Example of researching specific pricing information using the advanced search depth.

```bash
uv run .../search.py "Gemini 3 Flash Image API pricing" --depth advanced
```

--------------------------------

### Forbidden Import Example

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev-v2/templates/artifact-registry/RULE.md

Illustrates a forbidden import scenario where an L0 module attempts to import from an L2 module.

```typescript
// src/core/task.ts
import { fetchTask } from '../io/http';  // L0 → L2, BAD
```

--------------------------------

### Generate Image with Nano Banana (Text-to-Image)

Source: https://context7.com/lichamnesia/lich-skills/llms.txt

Use this command to generate an image from a text prompt. The default resolution is 1K. Ensure the GEMINI_API_KEY is set and the script is accessible.

```bash
# Setup
export GEMINI_API_KEY="YOUR_KEY_HERE"
command -v uv || curl -LsSf https://astral.sh/uv/install.sh | sh

SCRIPT=~/.claude/skills/lich-skills/skills/nano-banana/scripts/generate_image.py

# Generate — text-to-image at 1K (default)
uv run "$SCRIPT" \
    --prompt "A cinematic rainy Tokyo alley, neon reflections, 35mm, low angle" \
    --filename "tokyo-alley.png"
```

--------------------------------

### List Loaded Skills in Gemini CLI

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/gemini-cli-setup.md

Launches the Gemini CLI and lists all currently loaded skills.

```bash
gemini
> /extensions list
```

--------------------------------

### Lint Task Files with task-lint.sh

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev-v2/SKILL.md

Validates task file frontmatter, sizing, and verify command presence. Run at sprint open and in CI.

```bash
scripts/task-lint.sh <sprint-dir>
```

--------------------------------

### Generate an Image with Nano Banana 2

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/nano-banana/SKILL.md

Use this command to generate an image based on a text prompt. Specify the prompt, output filename, and desired resolution. The output is saved as a PNG file.

```bash
uv run ~/.claude/skills/lich-skills/skills/nano-banana/scripts/generate_image.py \
    --prompt "A cinematic rainy Tokyo alley, neon reflections, 35mm, low angle" \
    --filename "tokyo-alley.png" \
    --resolution 1K
```

--------------------------------

### News Sweep for OpenAI Codex Release

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/tavily-search/SKILL.md

Example of performing a news sweep for a specific event within the last 3 days, retrieving up to 10 results.

```bash
uv run .../search.py "OpenAI Codex release" --topic news --days 3 --max-results 10
```

--------------------------------

### Test Command

Source: https://github.com/lichamnesia/lich-skills/blob/main/skills/spec-driven-dev/templates/spec.md

Command to run project tests.

```bash
# Test
[test command]
```

--------------------------------

### Subagent Briefing Rules

Source: https://context7.com/lichamnesia/lich-skills/llms.txt

Apply these rules before writing any subagent prompt to prevent expensive context window mistakes. Focus on stripping context, replacing file contents with paths, summarizing, and compressing.

```shell
# Rule 1: Strip your own context (never paste conversation history)
# Rule 2: Replace file contents with paths (subagent has Read access)
# Rule 3: Replace context dumps with 1-3 sentence summaries
# Rule 4: Compress to ≤200 words
# Rule 5: Fan-out check — if N subagents share the same long context,
#          spawn 1 that handles all N items sequentially instead
```

--------------------------------

### Alternative lich-skills Install via AGENTS.md

Source: https://github.com/lichamnesia/lich-skills/blob/main/docs/codex-setup.md

Clones lich-skills to a custom project directory and configures Codex CLI to use it via the AGENTS.md file. This method keeps the skills outside the default ~/.codex directory.

```bash
git clone https://github.com/LichAmnesia/lich-skills.git ~/projects/lich-skills
```

```markdown
## Skills

Skill definitions live at `~/projects/lich-skills/skills/`:

- spec-driven-dev — Spec → Plan → Build → Test → Review → Ship workflow
- tavily-search   — Web search + extraction via Tavily
- nano-banana     — Text-to-image and image edits via Nano Banana 2

Load the matching `SKILL.md` before acting when a user request matches one of these triggers.
```