Struct SkillSpecBuilder 

pub struct SkillSpecBuilder { /* private fields */ }

Builder for SkillSpec.

Implementations

impl SkillSpecBuilder

pub fn owner(self, tag: impl Into<String>) -> Self

Set the consumer’s owner tag.

pub fn adopt_unowned(self, adopt: bool) -> Self

Adopt a skill directory that exists on disk but has no recorded owner. See SkillSpec::adopt_unowned.

pub fn description(self, d: impl Into<String>) -> Self

Set the SKILL.md frontmatter description.

pub fn when_to_use(self, value: impl Into<String>) -> Self

Set the SKILL.md frontmatter when_to_use field.

pub fn argument_hint(self, value: impl Into<String>) -> Self

Set the SKILL.md frontmatter argument-hint field.

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

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

Set the SKILL.md frontmatter arguments list.

pub fn disable_model_invocation(self, disable: bool) -> Self

Set the SKILL.md frontmatter disable-model-invocation field.

pub fn user_invocable(self, invocable: bool) -> Self

Set the SKILL.md frontmatter user-invocable field.

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

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

Set the SKILL.md frontmatter allowed-tools list (Claude only).

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

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

Set the SKILL.md frontmatter disallowed-tools list.

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

Set the SKILL.md frontmatter model override.

pub fn effort(self, effort: SkillEffort) -> Self

Set the SKILL.md frontmatter effort override.

pub fn context(self, context: SkillContext) -> Self

Set the SKILL.md frontmatter context mode.

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

Set the SKILL.md frontmatter agent field.

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

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

Set the SKILL.md frontmatter paths list.

pub fn shell(self, shell: SkillShell) -> Self

Set the SKILL.md frontmatter shell override.

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

Set the markdown body of SKILL.md.

pub fn asset(self, asset: SkillAsset) -> Self

Add one supporting file.

pub fn build(self) -> SkillSpec

Finalize the spec, panicking on missing or invalid fields.

Convenience wrapper around try_build() for tests and examples. Production code should prefer try_build() to propagate errors instead of panicking.

Panics

Panics if owner or description were never set.

pub fn try_build(self) -> Result<SkillSpec, AgentConfigError>

Finalize the spec, returning Result on missing or invalid fields.

This is the recommended way to build a spec in production code. See crate-level documentation for a full example.

Errors

• AgentConfigError::MissingSpecField with field = "owner" when SkillSpecBuilder::owner was never called, field = "frontmatter.description" when the skill frontmatter description is empty, or field = "body" when the body is empty.
• AgentConfigError::InvalidTag when name violates the kebab-case skill-name contract or owner_tag is malformed, or when a frontmatter scalar contains a control character.

Trait Implementations

impl Clone for SkillSpecBuilder

fn clone(&self) -> SkillSpecBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SkillSpecBuilder

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

Formats the value using the given formatter.