| name | irasutoya-search |
| description | Search and preview Irasutoya illustrations with the installed `irasutoya` command-line tool. Use this skill whenever the user wants to find, recommend, preview, randomly pull up, or get the page/image URL of an Irasutoya (ใใใใจใ) image โ from a topic, scene, Korean/Japanese/English phrase, visual description, emotion, character, object, or action โ even if they don't say "Irasutoya" by name but clearly want a free, cute illustration for a slide, ๋ฐํ์๋ฃ, blog, doc, or chat. Also use it to optimize vague requests into fast Japanese keyword candidates and to return page/image URLs. Do NOT use it to generate brand-new AI art (e.g. DALLยทE, Midjourney), draw charts or diagrams, design logos or icons, cut out/edit existing images, or recommend other stock-image sites โ it only searches Irasutoya's existing catalog. |
irasutoya-search
Overview
Use the installed irasutoya command-line tool to find Irasutoya illustrations. The skill drives the CLI that is already installed on the system โ it does not run, build, or modify any Ruby source. Optimize vague or natural-language requests into short Japanese search candidates before reporting results.
Command Choice
- Use
irasutoya random when the user wants an arbitrary Irasutoya image.
- Use
irasutoya search "query" when the user gives a topic, keyword, or phrase.
- Use
irasutoya help or irasutoya help COMMAND when the user asks what is available.
Expected commands:
irasutoya random
irasutoya search "cat"
irasutoya help search
The search command returns up to 3 matching images. Each result prints:
Page URLTitleDescription- one or more
Image URL lines
- an inline image preview when the terminal supports it
Fast Search Workflow
- Parse the request into visual facets:
- subject: person, animal, object, role, age, gender
- action/pose: observing, wondering, eating, running, pointing
- emotion/expression: curious, doubtful, happy, surprised, worried
- props/context: magnifying glass, question mark, school, office
- Generate 2-4 concise query candidates. Prefer Japanese nouns and short noun phrases because Irasutoya titles/descriptions are Japanese.
- Search candidates in parallel when possible. Avoid launching many broad searches; stop once a strong match appears.
- Score results before reporting. Prefer results whose title or description matches at least two facets.
- Return the best result first, with any close alternative only if it captures a different interpretation.
Pass condition: the first search batch should produce a 4-5 point result in the top two results for at least one candidate query. If it does not, run one refinement batch using the failure rules below.
Query Rubric
Score each candidate result from 0-5:
- +2 subject match: correct character/object type, such as
็ทใฎๅญ.
- +1 action/pose match: the visible activity matches, such as
่ฆณๅฏ.
- +1 emotion/expression match: the description/title implies the requested feeling, such as
ไธๆ่ญฐใใ, ็ๅ, or ใฏใฆใช.
- +1 prop/context match: important visual prop or setting appears, such as
่ซ็ผ้ก.
- +1 single-scene match: one concrete illustration, not a sheet of variations, when the user asked for one image.
- -1 if the result is too generic, multi-image, or only one small sub-image matches.
- -1 if the title includes
ใใใใใช, ่กจๆ
, or ใใผใๅฅ and the user asked for one concrete scene.
Cap the score at 5. Use a result scoring 4-5 as the primary answer. Use a 3 only when no better result appears and explain the limitation briefly.
Query Strategy
- Do not rely on long Korean natural-language strings as the only search. Try the user's wording once only if it is likely indexed, then optimize.
- Convert Korean descriptions into Japanese visual keywords:
- curious/wondering:
ไธๆ่ญฐ, ็ๅ, ใฏใฆใช
- boy:
็ทใฎๅญ
- girl:
ๅฅณใฎๅญ
- child:
ๅญไพ
- observe/look closely:
่ฆณๅฏ, ่ฆใ
- magnifying glass:
่ซ็ผ้ก
- question/question mark:
่ณชๅ, ็ๅ, ใฏใฆใช
- angry:
ๆใ, ๆใฃใ
- crying:
ๆณฃใ, ๆณฃใใฆใใ
- troubled/stuck:
ๅฐใฃใ, ๆฉใ
- office worker:
ไผ็คพๅก, ใตใฉใชใผใใณ
- computer:
ใใฝใณใณ
- doctor/lab coat:
ๅป่
, ็ฝ่กฃ
- Prefer 2-term Japanese queries such as
ไธๆ่ญฐ ็ทใฎๅญ, ็ๅ ็ทใฎๅญ, ่ซ็ผ้ก ็ทใฎๅญ.
- If a request includes a visible prop or action, search that prop/action plus subject before searching abstract emotions.
- If the first good result is a multi-image expression sheet, keep searching for a single-image scene when the user asked for a scene or full illustration.
- Try both dictionary-like and title-like forms for emotions/actions when the first form is weak:
ๆใ ๅฅณใฎๅญ can beat ๆใฃใ ๅฅณใฎๅญ for a single angry girl.ๅฐใฃใ ไผ็คพๅก can beat ๅฐใ ไผ็คพๅก for an office worker at a computer.ๆณฃใใฆใใ ่ตคใกใใ can surface the exact crying baby image, but check the second result when the first adds extra context.
- For occupational or role terms, try Irasutoya-style synonyms in the refinement batch, such as
ไผ็คพๅก and ใตใฉใชใผใใณ.
- Preserve the user's original intent in the final wording, not necessarily the original query text.
Failure Rules
Run exactly one refinement batch before reporting a partial match:
- If there are no results, switch word form or synonym:
ๅฐใ -> ๅฐใฃใ, ไผ็คพๅก -> ใตใฉใชใผใใณ.
- If results are expression sheets or grouped parts, add a concrete prop/action or try a more scene-like phrase.
- If broad role + prop searches return only grouped images, demote them and search a visual proxy such as
็ฝ่กฃ ใในใฏ.
- If the exact desired result appears as the second result, select it over a broader first result and mention the selected title.
Checking Candidate Queries (metadata only)
When comparing several candidate queries or checking whether the rubric holds, the inline image preview can flood the terminal. Suppress it by piping the CLI output through grep so only the metadata lines remain:
for q in "ไธๆ่ญฐ ็ทใฎๅญ" "่ซ็ผ้ก ็ทใฎๅญ"; do
echo "=== $q ==="
irasutoya search "$q" | grep -E "Page URL|Title|Description|Image URL"
done
Use at least these smoke cases:
- curious boy wondering: expect
ไธๆ่ญฐ ็ทใฎๅญ or ่ซ็ผ้ก ็ทใฎๅญ to find a 5-point result.
- angry girl: expect
ๆใ ๅฅณใฎๅญ to beat ๆใฃใ ๅฅณใฎๅญ because the latter returns expression sheets.
- office worker troubled at a computer: expect
ๅฐใฃใ ไผ็คพๅก to beat ๅฐใ ไผ็คพๅก and ใใฝใณใณ ๅฐใฃใ.
- crying baby: expect
ๆณฃใใฆใใ ่ตคใกใใ to include the exact simple crying baby image, even if it is not first.
The rubric is acceptable when at least three of four smoke cases find a 4-5 point result within the first refinement batch. If a case fails, add only the missing query synonym or failure rule; do not add broad generic search advice.
Running the CLI
The skill always uses the globally installed irasutoya executable:
irasutoya random
irasutoya search "query"
Quote multi-word queries. If the irasutoya command is not found, install it with gem install irasutoya-cli (requires Ruby >= 3.1); the gem ships the irasutoya, terminal_image, and thor dependencies it needs.
Terminal Preview Behavior
Inline previews depend on terminal_image. If the terminal does not support inline images, the CLI still prints the page/image URLs and warns:
warn: This terminal is not able to show images inline
warn: Please use iTerm2 or terminal installed libsixel.
Treat that warning as non-fatal. Return the printed URLs to the user when image rendering is unavailable.
Output Guidance
- Quote multi-word queries in shell commands.
- Report title, page URL, image URL, and a short reason why it matches.
- If the CLI prints multiple
Image URL lines for one page, identify the specific image that best matches instead of treating all images as equal.
- Do not scrape extra content unless the user asks for more than the CLI output.
