octos-org/octos-arc/skill-creator

my-skill/
  SKILL.md            # Required: agent instructions + frontmatter
  manifest.json       # Optional: declares tool executables
  Cargo.toml          # Optional: Rust crate (if tool is written in Rust)
  src/main.rs         # Optional: tool source code
  package.json        # Optional: Node.js dependencies
  scripts/            # Optional: helper scripts
  references/         # Optional: reference docs

---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
author: your-name
always: false
requires_bins: docker,kubectl
requires_env: GITHUB_TOKEN
---
 
# Skill Title
 
Instructions for the agent on how to use this skill.
Include examples, tool usage patterns, and best practices.

{
  "name": "my-skill",
  "version": "1.0.0",
  "tools": [
    {
      "name": "my_tool",
      "description": "What this tool does (shown to the LLM)",
      "input_schema": {
        "type": "object",
        "properties": {
          "query": {"type": "string", "description": "Search query"},
          "limit": {"type": "integer", "description": "Max results", "default": 10}
        },
        "required": ["query"]
      }
    }
  ]
}

stdin:  {"query": "rust async", "limit": 5}
stdout: {"output": "Results here...", "success": true}

// src/main.rs
use serde::{Deserialize, Serialize};
use std::io::Read;
 
#[derive(Deserialize)]
struct Input {
    query: String,
    #[serde(default = "default_limit")]
    limit: usize,
}
fn default_limit() -> usize { 10 }
 
#[derive(Serialize)]
struct Output {
    output: String,
    success: bool,
}
 
fn main() {
    let mut input = String::new();
    std::io::stdin().read_to_string(&mut input).unwrap();
    let args: Input = serde_json::from_str(&input).unwrap();
 
    // Your tool logic here
    let result = format!("Searched for '{}', limit {}", args.query, args.limit);
 
    let output = Output { output: result, success: true };
    println!("{}", serde_json::to_string(&output).unwrap());
}

// index.js
const input = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf8'));
const result = { output: `Processed: ${input.query}`, success: true };
console.log(JSON.stringify(result));

my-skills-repo/
  skill-a/
    SKILL.md
  skill-b/
    SKILL.md
    manifest.json
    src/main.rs
  shared-lib/          # Shared deps auto-detected
    ...