skill-forge

Skill Forge is an automated workshop that converts external resources—GitHub repositories, online documentation, and PDFs—into well-structured, reusable skills for Claude Code. It eliminates manual skill creation through smart source detection, supporting multiple formats including HTML docs, PDFs, and Office documents via markitdown. The tool features zero-configuration setup, intelligent path management for project or global installation, and progressive resource loading. It automatically detects llms.txt format for faster documentation fetching and includes cleanup tools for temporary materials. Operations teams and AI agent developers benefit by reducing skill development time while maintaining quality, modular knowledge packages.

[{"step":"Identify the resource to convert into a skill (GitHub repo, PDF, or documentation URL).","action":"Use the command: `skill-forge discover --source [URL_OR_FILE_PATH]` to analyze the resource and extract key components.","tip":"For GitHub repos, include the `--include-code` flag to analyze implementation details. For PDFs, ensure the text is OCR-friendly."},{"step":"Customize the extracted skill definition by filling in [PLACEHOLDERS] like inputs, outputs, and error handling.","action":"Edit the generated skill template in your IDE. For example, refine the `inputs` section to match your workflow requirements.","tip":"Use the `--validate` flag to check for missing required fields or invalid parameter types before proceeding."},{"step":"Implement the skill logic using the provided template. Add language-specific code snippets if needed.","action":"Run `skill-forge generate --source [SKILL_DEFINITION_FILE.json] --language [TARGET_LANGUAGE]` to scaffold the implementation.","tip":"Leverage the `--dependencies` flag to automatically include required libraries in your project's `requirements.txt` or `package.json`."},{"step":"Test the skill locally before integration. Validate inputs, outputs, and edge cases.","action":"Use `skill-forge test --skill [SKILL_NAME] --test-data [TEST_CASE.json]` to run automated tests.","tip":"Create test cases for error scenarios (e.g., invalid API keys, missing files) to ensure robustness."},{"step":"Integrate the skill into your target platform (e.g., Claude Code) and document its usage.","action":"Deploy using `skill-forge deploy --platform [PLATFORM_NAME] --skill [SKILL_NAME]` and share the skill with your team.","tip":"Use the `--publish` flag to add the skill to a shared repository for team access."}]