Skip to content

CHANGELOG.md

Latest commit

 

History

History
90 lines (74 loc) · 4.35 KB

CHANGELOG.md

File metadata and controls

90 lines (74 loc) · 4.35 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

1.1.2 - 2025-11-26

Fixed

  • Skills Section Clarity: Clarified that project skills supplement Claude Code's built-in Skill tool capabilities
    • Changed ambiguous "Only use skills listed" to "For project-specific tasks, only use skills listed"
    • Added note explaining native capabilities remain available alongside project skills
    • Prevents AI agents from ignoring their built-in skill system

1.1.1 - 2025-11-25

Added

  • Working Directory Reminder: read-skill command now displays actionable footer with copy-paste ready cd command to help AI agents execute scripts from correct directory

Changed

  • AGENTS.md Instructions: Updated base directory instruction from descriptive to imperative language for clearer guidance

1.1.0 - 2025-11-25

Added

  • Symfony 5.4 LTS Support: Extended compatibility to support Symfony 5.4+ (previously 6.0+)
    • Now supports: Symfony ^5.4|^6.0|^7.0
    • Enables usage in projects still on Symfony 5.4 LTS
  • GitHub Actions CI: Comprehensive continuous integration workflow
    • Test matrix across PHP 8.2, 8.3, 8.4
    • Test matrix across Symfony 5.4, 6.4, 7.1
    • Lowest dependencies testing (PHP 8.2 + Symfony 5.4)
    • Code quality checks (PHPStan level 8, PHP-CS-Fixer)
    • Code coverage reporting with Codecov integration
    • Automated testing on every push and pull request

Changed

  • Library Best Practices: Removed composer.lock from repository
    • Libraries should not commit lock files
    • Added composer.lock to .gitignore
    • Ensures proper dependency resolution for consumers

Fixed

  • Installation Documentation: Updated README with accurate Composer 2.2+ plugin authorization requirements
    • Added interactive installation prompt example
    • Added non-interactive/CI installation instructions
    • Documented allow-plugins configuration requirement

1.0.0 - 2025-11-24

Added

  • Automatic Skill Discovery: Discovers all installed packages with type ai-agent-skill
  • AGENTS.md Generation: Generates openskills-compatible XML skill registry
  • CLI Commands:
    • composer list-skills - List all available AI agent skills with package info
    • composer read-skill <name> - Display full SKILL.md content for a specific skill
  • SKILL.md Parsing: Validates and extracts YAML frontmatter following Claude Code specification
  • Multiple Skill Support: Packages can provide single or multiple skills via configuration
  • Convention Over Configuration: Zero-config setup with SKILL.md in package root
  • Comprehensive Validation:
    • Name format validation (kebab-case, max 64 chars)
    • Description length validation (max 1024 chars)
    • YAML syntax validation
    • Required field validation (name, description)
  • Edge Case Handling:
    • Duplicate skill names (last wins with warning)
    • Invalid frontmatter (skip with warning)
    • Missing SKILL.md files (skip with warning)
    • Malformed YAML (skip with detailed error)
  • Configuration Options:
    • extra.ai-agent-skill for custom skill paths
    • Support for single skill (string) or multiple skills (array)
  • Base Directory Support: Outputs directory containing SKILL.md for resource path resolution
  • Progressive Disclosure: Lightweight XML index, full details on demand
  • Atomic File Updates: Safe AGENTS.md updates with temp file + rename
  • Content Preservation: Updates only <skills_system> block, preserves other AGENTS.md content

Security

  • Absolute Path Rejection: Blocks absolute paths in extra.ai-agent-skill configuration
  • Path Traversal Protection: Uses realpath() to resolve canonical paths
  • XML Escaping: Properly escapes skill metadata in generated XML