skill-repo

The skill-repo agent skill is a comprehensive toolkit designed to streamline the lifecycle of AI agent skills. It provides a standardized framework for creating, maintaining, and distributing skills, ensuring that repositories adhere to the open-standard Agent Skills specification. This tool is essential for developers and teams managing complex agent ecosystems who require consistency across multiple skill repositories, particularly those leveraging the Netresearch DTT GmbH infrastructure. It bridges the gap between raw development and production-ready distribution by automating structural checks and CI/CD pipelines.

• Automated structure validation for .claude-plugin/plugin.json, composer.json, and SKILL.md files.

• Enforcement of split licensing models (MIT + CC-BY-SA-4.0) to protect both code and procedural knowledge.

• Integrated release management using signed git tags and reusable GitHub workflow callers (validate, release, auto-merge-deps, harness-verify).

• Multi-channel support for Composer (PHP), npm (Node), and the Claude Code marketplace.

• Version parity tracking between documentation, metadata, and git release tags.

• Built-in validation scripts for CI environments to ensure code quality and cross-platform (macOS/Linux) compatibility.

• Intended for developers building and deploying portable agent instructions and automated procedural agents.

• Use the validate-skill.sh script for pre-commit or CI-level compliance checks.

• Ensure composer.json uses the type 'ai-agent-skill' and requires 'netresearch/composer-agent-skill-plugin' for proper dependency discovery.

• Follow the recommended repository layout to support automated installation via npx (skills.sh) and Marketplace tools.

• Requires bash 4.3+, python3, and jq to operate effectively within your local terminal or CI environment.

• Maintains strict adherence to semver and prevents drift between package versions and git history through automated checks.