/ 
Langertha-Raider-0.503
/ Langertha::Raider::Skill

NAME

Langertha::Raider::Skill - Generate a "how to use raider" documentation file from a live Langertha::Raider::CLI configuration

VERSION

version 0.503

SYNOPSIS

my $skill = Langertha::Raider::Skill->new(app => $app);

# Plain markdown for any AI tool / human
my $md = $skill->markdown;

# Claude Code SKILL.md with frontmatter, written to .claude/skills/...
$skill->write_claude_skill('.claude/skills/raider/SKILL.md');

DESCRIPTION

Builds a self-describing how-to-use-raider document from a running Langertha::Raider::CLI instance. The generated text reflects the actual live configuration: selected engine and model, which web-search providers are currently enabled based on environment variables, which persona layer is active (default Langertha, a custom .raider/instructions.md or .raider.md, or a -M mission), and so on. Its tool table lists the tools the app mounts -- the same set its prompt describes and its engine offers (ADR 0005) -- each with its signature and the first sentence of its description, so the Perl tools appear only when granted and the Hall tools only under a Hall.

Two output variants are supported:

  • "markdown" — engine-agnostic markdown (no frontmatter). Drop into any README-ish place or feed it to a non-Claude agent.

  • "claude_skill" — Claude Code SKILL.md with a proper YAML frontmatter block. Write to .claude/skills/raider/SKILL.md (or wherever your skill directory lives) with "write_claude_skill".

app

The Langertha::Raider::CLI instance to describe. Required.

name

Skill name used in the Claude frontmatter. Defaults to raider.

description

One-line description used in the Claude frontmatter.

markdown

Returns the plain markdown document (no frontmatter).

claude_skill

Returns the markdown with a Claude Code YAML frontmatter block prepended.

write_markdown

$skill->write_markdown('/path/to/SKILL.md');

Writes the plain markdown to a file (creates parent dirs).

write_claude_skill

$skill->write_claude_skill;                 # default path
$skill->write_claude_skill('path/to/SKILL.md');

Writes the Claude SKILL.md (with frontmatter) to $path. The default path is .claude/skills/<name>/SKILL.md relative to the app's working root.

legacy_claude_skill

Returns the Path::Tiny of a Claude skill exported by an older release under the former default name (.claude/skills/app-raider/SKILL.md below the working root), or nothing when there is none. The --claude profile would load it next to the current one, so the CLI points it out after an export.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/langertha-raider/issues.

IRC

Join #langertha on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.