skill

var BuildCmd = &cobra.Command{
	Use:   "build <skill-folder-path>",
	Short: "Build a skill as a Docker image",
	Long: `Build a skill from a local folder containing SKILL.md.

This command reads the SKILL.md frontmatter to determine the skill name,
builds a Docker image, and optionally pushes it to a registry.

If the path contains multiple subdirectories with SKILL.md files, all will be built.`,
	Args:          cobra.ExactArgs(1),
	RunE:          runBuild,
	SilenceUsage:  true,
	SilenceErrors: false,
	Example: `  arctl skill build ./my-skill --image docker.io/myorg/my-skill:v1.0.0
  arctl skill build ./my-skill --image docker.io/myorg/my-skill:v1.0.0 --push
  arctl skill build ./my-skill --image docker.io/myorg/my-skill:v1.0.0 --platform linux/amd64`,
}

var DeleteCmd = &cobra.Command{
	Use:   "delete <skill-name>",
	Short: "Delete a skill from the registry",
	Long: `Delete a skill from the registry.

Examples:
  arctl skill delete my-skill --version 1.0.0`,
	Args: cobra.ExactArgs(1),
	RunE: runDelete,
}

var InitCmd = &cobra.Command{
	Use:   "init [skill-name]",
	Short: "Initialize a new agentic skill project",
	Long:  `Initialize a new agentic skill project.`,
	RunE:  runInit,
}

var ListCmd = &cobra.Command{
	Use:   "list",
	Short: "List skills",
	Long:  `List skills from connected registries.`,
	RunE:  runList,
}

var PublishCmd = &cobra.Command{
	Use:   "publish <skill-name|skill-folder-path>",
	Short: "Publish a skill to the registry",
	Long: `Publish a skill to the agent registry.

This command supports three modes:

1. From a local skill folder (with SKILL.md):
   arctl skill publish ./my-skill --git https://github.com/org/repo --version 1.0.0
   arctl skill publish ./my-skill --docker-image docker.io/myorg/my-skill:v1.0.0 --version 1.0.0

2. Direct registration with Git repository:
   arctl skill publish my-skill \
     --git https://github.com/org/repo/tree/main/skills/my-skill \
     --version 1.0.0 \
     --description "My remote skill"

3. Direct registration with a pre-built Docker image:
   arctl skill publish my-skill \
     --docker-image docker.io/myorg/my-skill:v1.0.0 \
     --version 1.0.0 \
     --description "My Docker skill"

For Git modes, SKILL.md must exist at the specified Git repository path.
In folder mode, the local skill folder must also contain a SKILL.md file with proper YAML frontmatter.

To build a skill as a Docker image, use "arctl skill build" instead.`,
	Args: cobra.ExactArgs(1),
	RunE: runPublish,
}

var PullCmd = &cobra.Command{
	Use:   "pull <skill-name> [output-directory]",
	Short: "Pull a skill from the registry and extract it locally",
	Long: `Pull a skill from the registry and extract its contents to a local directory.
Supports skills packaged as Docker images or hosted in Git repositories.

If output-directory is not specified, it will be extracted to ./skills/<skill-name>`,
	Args: cobra.RangeArgs(1, 2),
	RunE: runPull,
}

var ShowCmd = &cobra.Command{
	Use:   "show <skill-name>",
	Short: "Show details of a skill",
	Long:  `Shows detailed information about a skill from the registry.`,
	Args:  cobra.ExactArgs(1),
	RunE:  runShow,
}

var SkillCmd = &cobra.Command{
	Use:   "skill",
	Short: "Commands for managing skills",
	Long:  `Commands for managing skills.`,
	Args:  cobra.ArbitraryArgs,
	Example: `arctl skill list
arctl skill show my-skill
arctl skill publish ./my-skill
arctl skill delete my-skill --version 1.0.0`,
}