skillme 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 114461d15862bc97dd38791b09feb6920983fe95c0a5cdd87a3338f48fb5fbb8
+  data.tar.gz: 6d1fb4e10336c2f7ed9522041411901014fd96a0557627a47f7ae2164b26c932
+SHA512:
+  metadata.gz: 053ec30034ed3b461a927ceac34c997d002d6443c7cc702e95e967d8d4c015b9b90c9aeea9b4439e784a067166fc7b90295c297836e1a4db83acdc545b8fe43d
+  data.tar.gz: a9a8ee3f27643c6628fd621c4fa7af789597dbb6b06d87cc0d741eaff02fa1089d9c131e07194d7d5e6443e4b4136165a8fe7f8f8dd871da1bf562049916a755

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alan Alves
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,72 @@
+# skillme
+
+Claude Code skills written in Ruby. Zero gems, zero magic.
+
+## Installation
+
+```bash
+gem install skillme
+```
+
+## Usage
+
+```bash
+# List available skills
+skillme list
+
+# Install a skill (global — works in all projects)
+skillme install spreadsheet
+
+# Install for current project only
+skillme install spreadsheet --local
+
+# Remove a skill
+skillme remove spreadsheet
+```
+
+After installing, use `/spreadsheet` (or any skill name) directly in Claude Code.
+
+## Available Skills
+
+| Skill | Description |
+|-------|-------------|
+| spreadsheet | Read and write Google Sheets via REST API |
+
+## Why Ruby
+
+Ruby's stdlib is surprisingly powerful. `net/http`, `openssl`, `json`, `base64` — everything you need to talk to REST APIs is already there. No gem install, no bundler, no dependency hell.
+
+These skills prove a point: you don't need Python or TypeScript to build useful AI tooling. Ruby works. And if you already have Ruby installed (you probably do), these skills just work.
+
+## How It Works
+
+Skills are stored in this repository under `skills/`. The `skillme` gem is a thin CLI that fetches individual skills from GitHub and installs them to `~/.claude/skills/` (or `.claude/skills/` with `--local`).
+
+The skills themselves use **zero gems** — pure Ruby stdlib. The gem is just the installer.
+
+## Creating a Skill
+
+Each skill follows this structure:
+
+```
+skills/
+└── your-skill/
+    ├── SKILL.md           # Instructions for Claude
+    └── scripts/
+        └── your_script.rb # Ruby scripts (stdlib only)
+```
+
+### Conventions
+
+- **Ruby stdlib only** — no gems, no Gemfile, no bundler
+- **Scripts are self-contained** — each script does one thing
+- **SKILL.md is the interface** — Claude reads this to know how to use your skill
+- **Paths use `~/.claude/skills/`** — scripts reference their installed location
+
+## Author
+
+**Alan Alves** — [GitHub](https://github.com/alanalvestech) · [X](https://x.com/alanalvestech)
+
+## License
+
+[MIT](LICENSE)

data/bin/skillme

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require_relative '../lib/skillme/cli'
+
+Skillme::CLI.new.run(ARGV)

data/lib/skillme/cli.rb

@@ -0,0 +1,176 @@
+require 'json'
+require 'net/http'
+require 'uri'
+require 'fileutils'
+require_relative 'version'
+
+module Skillme
+  class CLI
+    REPO = "alanalvestech/skillme"
+    BRANCH = "main"
+    GLOBAL_DIR = File.expand_path("~/.claude/skills")
+    LOCAL_DIR = ".claude/skills"
+
+    def run(args)
+      command = args.shift
+
+      case command
+      when "install"  then install(args)
+      when "remove"   then remove(args)
+      when "list"     then list
+      when "version"  then puts "skillme v#{VERSION}"
+      when "help", nil then help
+      else
+        warn "Unknown command: #{command}"
+        help
+        exit 1
+      end
+    end
+
+    private
+
+    def install(args)
+      local = args.delete("--local")
+      name = args.first
+
+      abort "Usage: skillme install SKILL [--local]" unless name
+
+      target = local ? LOCAL_DIR : GLOBAL_DIR
+      skill_dir = File.join(target, name)
+
+      if Dir.exist?(skill_dir)
+        warn "Skill '#{name}' already installed at #{skill_dir}"
+        warn "Remove it first: skillme remove #{name}#{local ? ' --local' : ''}"
+        exit 1
+      end
+
+      puts "Fetching skill '#{name}' from #{REPO}..."
+
+      files = fetch_skill_files(name)
+      abort "Skill '#{name}' not found in the repository." if files.empty?
+
+      FileUtils.mkdir_p(skill_dir)
+
+      files.each do |path, content|
+        relative = path.sub("skills/#{name}/", "")
+        file_path = File.join(skill_dir, relative)
+        FileUtils.mkdir_p(File.dirname(file_path))
+        File.write(file_path, content)
+      end
+
+      puts "Installed '#{name}' to #{skill_dir}"
+      puts "Use /#{name} in Claude Code to get started."
+    end
+
+    def remove(args)
+      local = args.delete("--local")
+      name = args.first
+
+      abort "Usage: skillme remove SKILL [--local]" unless name
+
+      target = local ? LOCAL_DIR : GLOBAL_DIR
+      skill_dir = File.join(target, name)
+
+      unless Dir.exist?(skill_dir)
+        abort "Skill '#{name}' not found at #{skill_dir}"
+      end
+
+      FileUtils.rm_rf(skill_dir)
+      puts "Removed '#{name}' from #{skill_dir}"
+    end
+
+    def list
+      puts "Available skills in #{REPO}:\n\n"
+
+      skills = fetch_skill_list
+      if skills.empty?
+        puts "  (none found)"
+        return
+      end
+
+      skills.each do |skill|
+        puts "  #{skill[:name].ljust(20)} #{skill[:description]}"
+      end
+
+      puts "\nInstall with: skillme install SKILL_NAME"
+    end
+
+    def help
+      puts <<~HELP
+        skillme v#{VERSION}
+        Claude Code skills written in Ruby. Zero gems, zero magic.
+
+        Commands:
+          install SKILL [--local]   Install a skill (~/.claude/skills/ by default)
+          remove  SKILL [--local]   Remove an installed skill
+          list                      List available skills
+          version                   Show version
+          help                      Show this help
+      HELP
+    end
+
+    def fetch_skill_files(name)
+      tree = fetch_github_tree
+      prefix = "skills/#{name}/"
+
+      files = {}
+      tree.select { |item| item["path"].start_with?(prefix) && item["type"] == "blob" }.each do |item|
+        content = fetch_github_file(item["path"])
+        files[item["path"]] = content
+      end
+      files
+    end
+
+    def fetch_skill_list
+      tree = fetch_github_tree
+      skill_dirs = tree
+        .select { |item| item["path"].match?(%r{^skills/[^/]+$}) && item["type"] == "tree" }
+        .map { |item| item["path"].sub("skills/", "") }
+
+      skill_dirs.map do |name|
+        skill_md = tree.find { |item| item["path"] == "skills/#{name}/SKILL.md" }
+        description = if skill_md
+                        content = fetch_github_file(skill_md["path"])
+                        extract_description(content)
+                      else
+                        "(no description)"
+                      end
+        { name: name, description: description }
+      end
+    end
+
+    def extract_description(skill_md_content)
+      if skill_md_content =~ /^description:\s*(.+)$/
+        $1.strip
+      else
+        "(no description)"
+      end
+    end
+
+    def fetch_github_tree
+      uri = URI("https://api.github.com/repos/#{REPO}/git/trees/#{BRANCH}?recursive=1")
+      response = github_get(uri)
+      data = JSON.parse(response.body)
+      data["tree"] || []
+    end
+
+    def fetch_github_file(path)
+      uri = URI("https://raw.githubusercontent.com/#{REPO}/#{BRANCH}/#{path}")
+      github_get(uri).body
+    end
+
+    def github_get(uri)
+      req = Net::HTTP::Get.new(uri)
+      req["User-Agent"] = "skillme/#{VERSION}"
+      req["Accept"] = "application/vnd.github.v3+json"
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
+
+      unless response.is_a?(Net::HTTPSuccess)
+        abort "GitHub API error: #{response.code} #{response.message}"
+      end
+
+      response
+    end
+  end
+end

data/lib/skillme/version.rb

@@ -0,0 +1,3 @@
+module Skillme
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: skillme
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alan Alves
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: A CLI to install Claude Code skills written in pure Ruby (stdlib only).
+  Skills are fetched from GitHub and installed to ~/.claude/skills/.
+email:
+- alanalvestech@gmail.com
+executables:
+- skillme
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/skillme
+- lib/skillme/cli.rb
+- lib/skillme/version.rb
+homepage: https://github.com/alanalvestech/skillme
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/alanalvestech/skillme
+  bug_tracker_uri: https://github.com/alanalvestech/skillme/issues
+  changelog_uri: https://github.com/alanalvestech/skillme/releases
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Claude Code skills written in Ruby. Zero gems, zero magic.
+test_files: []