SwiftSkill

dependencies: [
    .package(url: "https://github.com/1amageek/swift-skills.git", from: "0.1.0")
]

import SwiftSkill

var skill = Skill(
    name: "deploy-staging",
    description: "Deploy the current branch to the staging environment",
    license: "MIT",
    allowedTools: ["Bash(git:*)", "Read"],
    body: """
    ## Steps

    1. Run the test suite
    2. Build the project
    3. Deploy to staging using `scripts/deploy.sh`
    """,
    supportingFiles: [
        SupportingFile(relativePath: "scripts/deploy.sh", text: "#!/bin/bash\necho deploy"),
    ]
)

// Claude Code extensions (stored in frontmatter)
skill.disableModelInvocation = true
skill.skillContext = "fork"
skill.agent = "Explore"
skill.model = "opus"

// Codex configuration (stored as bundled data)
try skill.setConfiguration(CodexConfiguration(
    interface: CodexConfiguration.Interface(displayName: "Deploy Staging"),
    policy: CodexConfiguration.Policy(allowImplicitInvocation: false)
))

let parser = SkillParser()
let writer = SkillWriter()

// Parse from a string
let skill = try parser.parse(markdownString)

// Parse from a file
let skill = try parser.parse(at: fileURL)

// Parse a full directory bundle
let skill = try parser.parseDirectory(at: directoryURL)

// Write to a string
let markdown = try writer.write(skill)

// Write to a file
try writer.write(skill, to: fileURL)

// Write a full directory bundle
try writer.writeDirectory(skill, to: directoryURL)

let store = SkillStore(rootURL: skillsDirectoryURL)

// Discover all skills
let skills = try store.discover()

// Read a specific skill
let skill = try store.skill(named: "deploy-staging")

// Save (creates directory structure)
try store.save(skill)

// Delete
try store.delete(named: "deploy-staging")

let provider = SkillProvider.claudeCode

// ~/.claude/skills/
let personal = provider.personalSkillsURL

// <project>/.claude/skills/
let project = provider.projectSkillsURL(in: projectRootURL)

// Both paths, priority-ordered
let candidates = provider.discoveryURLs(projectRoot: projectRootURL)

// Write
try skill.setConfiguration(CodexConfiguration(
    interface: CodexConfiguration.Interface(
        displayName: "My Skill",
        brandColor: "#3B82F6"
    ),
    policy: CodexConfiguration.Policy(allowImplicitInvocation: false),
    dependencies: CodexConfiguration.Dependencies(
        tools: [
            CodexConfiguration.ToolDependency(
                type: "mcp",
                value: "my-server",
                transport: "streamable_http",
                url: "https://example.com"
            )
        ]
    )
))

// Read
let codex = try skill.configuration(CodexConfiguration.self)
print(codex?.interface?.displayName)

// Check
skill.hasConfiguration(CodexConfiguration.self)

// Convenience accessors
skill.codexDisplayName = "My Skill"
skill.allowImplicitInvocation = false

struct MyConfig: ConfigurationRepresentable {
    var endpoint: String

    init(configurationData data: Data) throws {
        self = try JSONDecoder().decode(Self.self, from: data)
    }

    func configurationData() throws -> Data {
        try JSONEncoder().encode(self)
    }
}

// Use in a Skill bundle (no path needed)
try skill.setConfiguration(MyConfig(endpoint: "https://api.example.com"))

// For I/O, tell the parser/writer where to find the file
let mappings = ConfigurationFileMapping.defaults + [
    ConfigurationFileMapping(MyConfig.self, relativePath: "agents/myprovider.json")
]
let store = SkillStore(rootURL: url, configurationMappings: mappings)

let validator = SkillValidator()
let errors = validator.validate(skill)

if errors.isEmpty {
    // Skill is valid
} else {
    for error in errors {
        print(error) // e.g. .nameInvalidCharacters, .descriptionEmpty
    }
}

skill.supportingFiles = [
    SupportingFile(relativePath: "scripts/run.sh", text: "#!/bin/bash\necho hello"),
    SupportingFile(relativePath: "references/API.md", text: "# API Reference"),
    SupportingFile(relativePath: "assets/config.json", content: jsonData),
]

// Access content
if let text = skill.supportingFiles.first?.textContent {
    print(text)
}

skill.extensions["retry-count"] = .int(3)
skill.extensions["timeout"] = .double(30.5)
skill.extensions["tags"] = .array([.string("deploy"), .string("ci")])

let retries = skill.extensions["retry-count"]?.intValue  // 3

.draggable(skill)
.dropDestination(for: Skill.self) { skills, _ in
    // Handle dropped skills
}