CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

This is HeteroCat Skills - a Claude Code skills library containing agent skills for content creation, AI image generation, financial analysis, research, and more. Skills are located in .claude/skills/.

Skill Naming Conventions

Skills are organized with category prefixes:

Common Commands

Package All Skills

# Package as .skill files (Claude Code native format)
python package_skills.py

# Package as .zip files (universal format)
python package_zip.py

Output directories:

• .skill files → dist/
• .zip files → zip_dist/

Create a New Skill

# Initialize new skill structure
python .claude/skills/a-skill-creator/scripts/init_skill.py my-skill --path ./.claude/skills

# Package a single skill
python .claude/skills/a-skill-creator/scripts/package_skill.py .claude/skills/my-skill

Skill Development

# Validate skill structure
python .claude/skills/a-skill-creator/scripts/quick_validate.py .claude/skills/my-skill

# Run skill evaluation (creates test scenarios)
python .claude/skills/a-skill-creator/scripts/run_eval.py .claude/skills/my-skill

Skill Structure

Each skill directory follows this structure:

.claude/skills/{skill-name}/
├── SKILL.md                    # Required: skill definition with frontmatter
├── scripts/                    # Optional: executable scripts
│   └── *.py, *.js, *.sh
├── references/                 # Optional: documentation, schemas
│   └── *.md
├── assets/                     # Optional: images, templates
│   └── *
└── agents/                     # Optional: subagent definitions
    └── *.md

The SKILL.md file must include YAML frontmatter:

---
name: skill-name
description: "Description of when to use this skill"
---

Environment Variables

All API keys and credentials are stored in .env at the repository root. Key variables include:

Key Files

Installing Skills

Skills can be installed in Claude Code via:

/skills install /path/to/skill-name.skill

External Skills

Some skills are sourced from external GitHub repos and tracked in skills-lock.json:

• fund-advisor → realqiyan/fund-advisor
• fund-assistant → xer97/fund-assistant
• fund-screener → sososun/mutual-fund-skills
• fundamentals → staskh/trading_skills
• agent-browser → vercel-labs/agent-browser

When updating external skills, verify the source repository for changes.

Language

默认使用中文回复用户。