oxios-kernel 1.2.0

Oxios kernel: supervisor, event bus, state store
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

//! Skills.sh marketplace integration.
//!
//! Provides a client for searching and fetching skills from the [skills.sh]
//! registry, plus an installer that writes skill files directly (no zip
//! extraction needed — skills.sh provides file contents via JSON API).
//!
//! # Comparison with ClawHub
//!
//! | Aspect       | ClawHub                        | Skills.sh                       |
//! |--------------|--------------------------------|----------------------------------|
//! | Distribution | Zip archive download           | JSON API with file contents      |
//! | Discovery    | ClawHub search API             | Skills.sh search + leaderboard   |
//! | Source       | `clawhub.ai`                   | GitHub repos via skills.sh       |
//! | Auth         | `CLAWHUB_TOKEN` env var        | `SKILLS_SH_TOKEN` env var        |
//!
//! # Directory Layout
//!
//! ```text
//! workspace/
//!   skills/
//!     frontend-design/
//!       SKILL.md
//!       .skills_sh/
//!         origin.json   ← per-skill origin metadata
//! ```
//!
//! # Example
//!
//! ```ignore
//! use oxios_kernel::skill::skills_sh::{SkillsShInstaller, SkillsShInstallResult};
//! use std::path::PathBuf;
//!
//! # async fn example() -> anyhow::Result<()> {
//! let installer = SkillsShInstaller::new(
//!     PathBuf::from("/home/user/.oxios/skills"),
//!     None,  // default base URL
//!     None,  // no API key (reads SKILLS_SH_TOKEN env var)
//! );
//!
//! let result = installer
//!     .install("vercel-labs/agent-skills/frontend-design")
//!     .await?;
//! println!("Installed {} files to {}", result.file_count, result.target_dir.display());
//! # Ok(())
//! # }
//! ```

pub mod client;
pub mod installer;
pub mod types;

pub use client::SkillsShClient;
pub use installer::{SkillsShInstallResult, SkillsShInstaller, SkillsShOrigin};
pub use types::{
    SkillsShAuditEntry, SkillsShAuditResponse, SkillsShCuratedOwner, SkillsShCuratedResponse,
    SkillsShFile, SkillsShListResponse, SkillsShPagination, SkillsShSearchResponse, SkillsShSkill,
    SkillsShSkillDetail,
};