Struct SkillDraft 

pub struct SkillDraft { /* private fields */ }

A skill to be written to disk.

name and description are required by the specification; everything else is optional and is omitted from the generated file when unset.

Example

use adk_skill::SkillDraft;

let draft = SkillDraft::new("disk-triage", "Diagnose low disk space. Use when a disk alert fires.")
    .with_body("1. Check the largest directories.\n2. Report growth rate.")
    .with_tags(["ops"])
    .with_allowed_tools(["read_file"]);

assert_eq!(draft.name(), "disk-triage");

Implementations

impl SkillDraft

pub fn new(name: impl Into<String>, description: impl Into<String>) -> Self

Creates a draft with the two required fields.

pub fn with_body(self, body: impl Into<String>) -> Self

Sets the instructional Markdown body.

pub fn with_version(self, version: impl Into<String>) -> Self

Sets the version identifier.

pub fn with_license(self, license: impl Into<String>) -> Self

Sets the license identifier.

pub fn with_compatibility(self, compatibility: impl Into<String>) -> Self

Sets the environment requirements.

pub fn with_tags<I, S>(self, tags: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Sets the discovery tags.

pub fn with_allowed_tools<I, S>(self, tools: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Sets the pre-approved tool names.

pub fn with_references<I, S>(self, references: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Sets the supporting resource paths.

pub fn with_trigger(self, trigger: bool) -> Self

Requires explicit invocation by name rather than automatic selection.

pub fn with_hint(self, hint: impl Into<String>) -> Self

Sets the guided-input hint.

pub fn with_metadata(self, metadata: HashMap<String, Value>) -> Self

Sets the extension metadata.

Useful for recording provenance — which incident a learned skill came from, when it was promoted, and what evidence supported it.

pub fn with_metadata_entry(self, key: impl Into<String>, value: Value) -> Self

Adds one extension metadata entry.

pub fn with_triggers<I, S>(self, triggers: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Sets the file glob patterns that activate this skill.

pub fn name(&self) -> &str

The skill’s name.

pub fn validate(&self) -> SkillResult<()>

Checks the draft against the specification.

Errors

Returns SkillError::Validation when the name is invalid or the description is empty.

pub fn to_markdown(&self) -> SkillResult<String>

Renders the draft as skill Markdown: YAML frontmatter, then the body.

The output is what parse_skill_markdown accepts, so a draft written and reparsed yields equivalent content.

Errors

Returns an error if the draft fails validate or the frontmatter cannot be serialized.

Trait Implementations

impl Clone for SkillDraft

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SkillDraft

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SkillDraft

fn default() -> Self

Returns the “default value” for a type.