/ 
App-Raider-0.003
/ App::Raider::Skill

NAME

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

VERSION

version 0.003

SYNOPSIS

my $skill = App::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/app-raider/SKILL.md');

DESCRIPTION

Builds a self-describing how-to-use-raider document from a running App::Raider 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 vs. a custom .raider.md), and so on.

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/app-raider/SKILL.md (or wherever your skill directory lives) with "write_claude_skill".

app

The App::Raider instance to describe. Required.

name

Skill name used in the Claude frontmatter. Defaults to app-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.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-app-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.