CLAUDE.md

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 for comprehensive guidance on creating and distributing plugin marketplaces.

Project Structure

.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