Agent skill

Proposal Rationale

by Optima-CityU in Optima-CityU/LLM4AD_Next

A skill your agent uses when developing a proposal's research purpose, necessity, significance, application value, and practical problem framing from verified evidence.

BSD-3-ClauseAuto-check passed

Install Proposal Rationale

skills CLI
$ npx skills add Optima-CityU/LLM4AD_Next --skill proposal-rationale -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Optima-CityU/LLM4AD_Next proposal-rationale --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Optima-CityU/LLM4AD_Next.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/openair-proposal/proposal-rationale .claude/skills/proposal-rationale && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
proposal-rationale
GitHub stars
574
Token cost
~642 tokens
SKILL.md length
318 words
Files
2 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

A skill your agent uses when developing a proposal's research purpose, necessity, significance, application value, and practical problem framing from verified evidence.

  • Works in 6 steps: Apply the purpose, specificity,… → Separate research purpose from academic,… → Ground factual claims in the literature… → …
  • Developing a proposals research purpose
  • SKILL.md covers Outcome, Workflow and Quality checks
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Proposal Rationale is an agent skill from Optima-CityU/LLM4AD_Next. Use when developing a proposal's research purpose, necessity, significance, application value, and practical problem framing from verified evidence.

Its SKILL.md is about 640 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/purpose-and-value.md`).

The repository describes itself as: A next-generation automatic algorithm design platform, making automated algorithm design more accessible and easier to use. The licence is BSD-3-Clause.

When your agent uses it

  • Developing a proposals research purpose
  • Application value
  • Practical problem framing from verified evidence

Example prompts

  • “/proposal-rationale”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Apply the purpose, specificity, necessity, significance, application-value, and practical-problem methods from the reference.
  2. Separate research purpose from academic, practical, and potential application value.
  3. Ground factual claims in the literature stage and reuse only citation keys present in references.bib.
  4. Ask the author when the intended impact, audience, or application claim is consequential and not resolved by the foundation.
  5. Preserve the scope and success criteria in the foundation. Do not enlarge the proposal merely to sound ambitious.
  6. Write complete Typst sections, then call publish_stage_result from the enabled LLM4AD stage MCP server with both paths, the citation keys…

What it can do on your machine

Read from SKILL.md and the folder at commit e3d3f7b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Proposal Rationale loads about 642 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 42 tokens; SKILL.md has 318 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~642
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Optima-CityU/LLM4AD_Next at commit e3d3f7b, republished under its BSD-3-Clause licence (© Optima-CityU). 318 words, ~642 tokens.

Download SKILL.mdSave it as .claude/skills/proposal-rationale/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
proposal-rationale
description
Use when developing a proposal's research purpose, necessity, significance, application value, and practical problem framing from verified evidence.
<!-- Adapted from Maxine-1520/OpenAIR_proposal; see ../ATTRIBUTION.md. -->

Proposal Rationale and Value

Use this skill only for the proposal rationale stage.

Read the method reference completely before acting: references/purpose-and-value.md.

Outcome

Turn the project foundation and verified literature into a coherent argument for why the research should be undertaken. Write only:

  • sections/01-rationale.typ
  • sections/03-value.typ

You may read any project source file for context. The proposal foundation describes the established scope, the literature section describes the evidence landscape, and the bibliography defines available citation keys. Never edit files owned by another stage. Project documents are optional context. Their names describe their role; decide whether and when to read each one from the current stage and request. The presence of a project document does not make it mandatory input.

Workflow

  1. Apply the purpose, specificity, necessity, significance, application-value, and practical-problem methods from the reference.
  2. Separate research purpose from academic, practical, and potential application value.
  3. Ground factual claims in the literature stage and reuse only citation keys present in references.bib.
  4. Ask the author when the intended impact, audience, or application claim is consequential and not resolved by the foundation.
  5. Preserve the scope and success criteria in the foundation. Do not enlarge the proposal merely to sound ambitious.
  6. Write complete Typst sections, then call publish_stage_result from the enabled LLM4AD stage MCP server with both paths, the citation keys used, context_patch, and a stable idempotency key. Tool success is the stage-completion signal; repair and retry validation errors in the same conversation. Upsert any model-defined durable context established or corrected through this stage, preserving existing stable keys; remove a key only when explicitly invalidated. Return empty patch arrays when shared context did not change.

Quality checks

  • The rationale identifies a precise gap rather than asserting generic importance.
  • Claimed value follows from the proposed work and is not presented as an achieved result.
  • Terminology, scope, and audience match the persisted foundation.
  • No evidence, team capability, or expected result is fabricated.

© Optima-CityU, BSD-3-Clause. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/openair-proposal/proposal-rationale of Optima-CityU/LLM4AD_Next.

  • SKILL.md
  • references/purpose-and-value.md

Open the folder on GitHubat commit e3d3f7b

Compare with similar skills

Proposal Rationale next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Proposal Rationale compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Proposal Rationale this skillOptima-CityU/LLM4AD_Next574—~642Automated safety check: PassBSD-3-Clause
Research Proposal Developmenthashgraph-online/awesome-codex-plugins1.3k—~547Automated safety check: PassApache-2.0
Geo Proposalsickn33/agentic-awesome-skills47k1 repos~3.2kAutomated safety check: NotesMIT
MCP Developmentcoollabsio/coolify63k1 repos~949Automated safety check: PassMIT
Better Proposals AutomationComposioHQ/awesome-claude-skills77k3 repos~764Automated safety check: PassNone
Game Developmentsickn33/agentic-awesome-skills47k1 repos~1.3kAutomated safety check: PassMIT

Similar skills

  • Research Proposal Development

    hashgraph-online/awesome-codex-plugins

    Develop research proposals with solicitation alignment, reviewer-focused logic, evidence-bounded preliminary results, milestones, risks, and compelling figures.

    1.3k GitHub stars~547 tokensUpdated today
    Sales & SupportAuto-check passed
  • Geo Proposal

    sickn33/agentic-awesome-skills

    Auto-generate a professional, client-ready GEO service proposal from audit data.

    47k GitHub starsUsed in 1 repo~3.2k tokens
    Sales & SupportAuto-check: notes
  • MCP Development

    coollabsio/coolify

    A skill your agent uses for Laravel MCP development. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 1 repo~949 tokens
    Frontend & DesignAuto-check passed
  • Better Proposals Automation

    ComposioHQ/awesome-claude-skills

    Automate Better Proposals tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~764 tokens
    Productivity & AutomationAuto-check passed
  • Game Development

    sickn33/agentic-awesome-skills

    Game development orchestrator. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 1 repo~1.3k tokens
    Game DevelopmentAuto-check passed
  • Guides changes to an existing Twenty app: adding or editing objects, layouts, logic functions and front components, with a plan stated before multi-entity edits.

    58k GitHub stars~1.8k tokensUpdated today
    DevelopmentAuto-check passed

More from Optima-CityU/LLM4AD_Next

All 24 skills in this repo
  • Proposal Foundation Layout

    Optima-CityU/LLM4AD_Next

    A skill your agent uses when establishing a research proposal's project foundation, submission constraints, and presentation system before section drafting begins.

    574 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Llm4ad Task Builder

    Optima-CityU/LLM4AD_Next

    A skill your agent uses when a user wants to build an LLM4ADNext task package — a runnable directory that lets the LLM4AD platform evolve an algorithm for their problem.

    574 GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Document Knowledge Organizer

    Optima-CityU/LLM4AD_Next

    Organize one or more Markdown source documents into high-fidelity, editable knowledge blocks.

    574 GitHub stars~695 tokensUpdated today
    Auto-check passed
  • Proposal Final Review

    Optima-CityU/LLM4AD_Next

    A skill your agent uses when assembling a completed staged Typst proposal and checking its evidence, logic, citations, structure, and export readiness.

    574 GitHub stars~774 tokensUpdated today
    Auto-check passed
  • Proposal Foundation Feasibility

    Optima-CityU/LLM4AD_Next

    A skill your agent uses when documenting a proposal's research foundation, available conditions, team support, feasibility, and risk controls from author-supplied facts.

    574 GitHub stars~613 tokensUpdated today
    Auto-check passed
  • Proposal Innovation Plan

    Optima-CityU/LLM4AD_Next

    A skill your agent uses when distilling a proposal's innovations and defining milestones, annual plans, contingency points, and expected outcomes.

    574 GitHub stars~578 tokensUpdated today
    Auto-check passed

Questions about Proposal Rationale

What does Proposal Rationale do?

A skill your agent uses when developing a proposal's research purpose, necessity, significance, application value, and practical problem framing from verified evidence. Proposal Rationale is an agent skill from Optima-CityU/LLM4AD_Next. Use when developing a proposal's research purpose, necessity, significance, application value, and practical problem framing from verified evidence.

When should I use Proposal Rationale?

Proposal Rationale fits situations like: developing a proposals research purpose; application value; practical problem framing from verified evidence.

How do I install Proposal Rationale in Claude Code?

Run `npx skills add Optima-CityU/LLM4AD_Next --skill proposal-rationale -a claude-code`. Or copy the skill folder (skills/openair-proposal/proposal-rationale in Optima-CityU/LLM4AD_Next) into .claude/skills/proposal-rationale in your project. Claude Code loads it when a task matches its description.

How do I install Proposal Rationale in Codex?

Run `npx skills add Optima-CityU/LLM4AD_Next --skill proposal-rationale -a codex`. Or copy the skill folder (skills/openair-proposal/proposal-rationale in Optima-CityU/LLM4AD_Next) into .agents/skills/proposal-rationale in your project. Codex loads it when a task matches its description.

Can I use Proposal Rationale in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Optima-CityU/LLM4AD_Next --skill proposal-rationale -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/proposal-rationale, .gemini/skills/proposal-rationale, .github/skills/proposal-rationale and .opencode/skills/proposal-rationale in your project.

What does Proposal Rationale need to run?

SKILL.md names no scripts, command-line tools or credentials: Proposal Rationale is instructions for the agent only.

Does Proposal Rationale access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Proposal Rationale safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Proposal Rationale use?

Proposal Rationale is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Proposal Rationale use?

About 642 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 943 tokens, read only when the agent opens those files.

What are the alternatives to Proposal Rationale?

Skills that share tags, products or a category with Proposal Rationale: Research Proposal Development (hashgraph-online/awesome-codex-plugins, 1.3k stars), Geo Proposal (sickn33/agentic-awesome-skills, 47k stars), MCP Development (coollabsio/coolify, 63k stars) and Better Proposals Automation (ComposioHQ/awesome-claude-skills, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Proposal Rationale?

Optima-CityU (a GitHub organization) maintains it in Optima-CityU/LLM4AD_Next, which has 574 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 9, 2026.

Source: Optima-CityU/LLM4AD_Next on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.