# CLAUDE.md

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

## Project Overview

This is an **AI skills marketplace for journalism** - not a traditional software project. It contains structured markdown workflows that AI assistants can execute for journalistic tasks. There is no build system, package.json, or test suite.

**Distribution:** Skills are distributed via Claude Code marketplace integration.

- Users add the marketplace: `/plugin marketplace add fdaudens/ai-journalism-skills`
- Or install specific skills: `/plugin install fact-checker@ai-journalism-skills`

**Documentation:** See [CREATE-MARKETPLACE.md](CREATE-MARKETPLACE.md) for comprehensive guidance on creating and distributing plugin marketplaces.

## Project Structure

```text
.claude-plugin/
  marketplace.json        # Registers skills for marketplace distribution
skills/
  <skill-name>/
    .claude-plugin/
      plugin.json         # Skill metadata (name, version, category, tags)
    skills/<skill-name>/
      SKILL.md            # Core skill instructions (YAML frontmatter + workflow)
      references/         # Supporting documentation (optional)
```

The nested `skills/<skill-name>/skills/<skill-name>/` structure is intentional for marketplace organization.

## Skill Format

Each skill consists of:

1. **SKILL.md** - YAML frontmatter with `name` and `description`, followed by markdown instructions defining the workflow. The description should include trigger phrases for when the skill should be invoked.

2. **plugin.json** - Metadata for marketplace registration:
   - `name`, `description`, `version`, `author`
   - `category` (e.g., "verification")
   - `tags` for discoverability

3. **references/** (optional) - Supporting documentation the skill can reference

## Adding a New Skill

1. Create `skills/<skill-name>/.claude-plugin/plugin.json` with metadata
2. Create `skills/<skill-name>/skills/<skill-name>/SKILL.md` with workflow
3. Add optional reference files in `skills/<skill-name>/skills/<skill-name>/references/`
4. Register in `.claude-plugin/marketplace.json` under the `plugins` array

## Current Skills

- **fact-checker** - Comprehensive verification system with 5-step workflow:
  1. Claim Extraction
  2. Source Research
  3. Credibility Assessment
  4. Quality Rating (weighted scoring formula)
  5. Report Generation

## Contribution Guidelines (from index.html)

1. Create skill following the directory structure above
2. Write skill instructions that are specific, tool-aware, and include step-by-step workflows
3. Test with your AI assistant before submitting
4. Submit PR with the skill directory and updated marketplace.json