skill-forge

🥈Silver

Skill Forge automates the creation of reusable skills from external resources like GitHub repositories, online documentation, and PDFs. Operations teams benefit by streamlining skill development and integration into Claude Code. It connects to version control systems and documentation platforms, enhancing workflow automation.

40100Updated 1mo ago

Intermediate30min to implementautomation

Saves ~90 min per use

Quick InstallView Source

git clone https://github.com/WilliamSaysX/skill-forge.git

Works with:

Claude

Overview

About This Skill

How to Use

[{"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."}]

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/WilliamSaysX/skill-forge

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Generate a reusable AI skill for [TARGET_PLATFORM] by analyzing the following resource: [URL_OR_FILE_PATH]. Extract the core functionality, key parameters, and example use cases. Structure the output as a valid skill definition with clear inputs, outputs, and error handling. Include a sample implementation in [LANGUAGE_IF_SPECIFIED].

Example Output

```json
{
  "skill_name": "GitHubIssueTracker",
  "description": "Automates GitHub issue tracking and resolution workflows by integrating with GitHub API.",
  "inputs": {
    "repo_owner": "string (required)",
    "repo_name": "string (required)",
    "labels": "array (optional)",
    "priority_threshold": "integer (optional, default=3)"
  },
  "outputs": {
    "issues_processed": "integer",
    "resolved_issues": "integer",
    "escalated_issues": "array",
    "summary_report": "string"
  },
  "implementation": {
    "language": "Python",
    "dependencies": ["PyGithub>=1.58", "requests>=2.28"],
    "code": "... (truncated for brevity) ..."
  },
  "example_use_case": "Track and resolve high-priority issues in the 'acme/website' repository with labels 'bug' or 'critical'.",
  "error_handling": {
    "invalid_repo": "Returns error with suggestion to verify repository exists",
    "api_limit": "Implements exponential backoff and notifies user when rate limit is hit"
  }
}
```

**Sample Output:**
Processing repository 'acme/website' with priority_threshold=2...
- Issues processed: 47
- Resolved issues: 12 (25.5%)
- Escalated issues: ["ISSUE-89", "ISSUE-102"]
- Summary: 8 critical bugs remain unresolved. Suggested next steps: Prioritize ISSUE-89 due to customer impact.

The skill was successfully integrated into Claude Code via the `skill-forge` CLI tool using the command:
`skill-forge generate --source https://github.com/acme/website --platform claude-code`