Agent skill

Run Agentic Dse

by Shinei-Nouzen-Arch in Shinei-Nouzen-Arch/FPGA-Agent

Initialize, run, resume, and inspect FPGA HLS design-space exploration with Explorer, Exploiter, and Innovator workers.

GPL-2.0Auto-check passedDevelopment

Install Run Agentic Dse

skills CLI
$ npx skills add Shinei-Nouzen-Arch/FPGA-Agent --skill run-agentic-dse -a claude-code

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

GitHub CLI
$ gh skill install Shinei-Nouzen-Arch/FPGA-Agent run-agentic-dse --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/Shinei-Nouzen-Arch/FPGA-Agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/DSE-agent .claude/skills/run-agentic-dse && 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
run-agentic-dse
GitHub stars
180
Token cost
~2.7k tokens
SKILL.md length
1,325 words
Files
24 (incl. references)
Skills in repo
10
Repo updated
First seen
Licence
GPL-2.0

At a glance

Initialize, run, resume, and inspect FPGA HLS design-space exploration with Explorer, Exploiter, and Innovator workers.

  • Works in 7 steps: Identify the benchmark from the request… → Use prompts/req_parser.md with… → Run the Parser and then… → …
  • Read-only requirement review
  • SKILL.md covers Roots and routing, Publication boundary, Initialize or reconcile an… and Execute rounds, plus 2 more sections
  • Runs Python scripts from its folder

What it does

Run Agentic Dse is an agent skill from Shinei-Nouzen-Arch/FPGA-Agent. Initialize, run, resume, and inspect FPGA HLS design-space exploration with Explorer, Exploiter, and Innovator workers. Also use for read-only requirement review, architecture advice, Pareto analysis, and convergence diagnosis without automatically launching experiments.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 28 other files, including reference files (for example `AGENTS.md`, `agent.md` and `agents/openai.yaml`).

It sits in Development. The licence is GPL-2.0.

When your agent uses it

  • Read-only requirement review
  • Architecture advice
  • Pareto analysis
  • Convergence diagnosis without automatically launching experiments

Example prompts

  • “/run-agentic-dse”

Requirements

  • Python 3

Workflow steps

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

  1. Identify the benchmark from the request and project context. Support an existing benchmarks// or legacy designs// layout; do not rename…
  2. Use prompts/req_parser.md with src/req_parser_schema.json. First resolve facts from the conversation and selected project. Distinguish…
  3. Run the Parser and then prompts/architect.md sequentially, normally locally. Their outputs are proposals under tmp//; only Main promotes…
  4. Main records one validation policy and execution budget for the assignment chain. A requested formal DSE run authorizes its normal…
  5. For a new authorized run, create only missing runtime files, with consistent benchmark and run identity
  6. Preserve existing state and user edits. Infer or migrate unambiguous legacy metadata without inventing validation. Reconcile missing files…
  7. Record target facts from the selected project or installed tools in private project state. Do not package a real project's platform…

What it can do on your machine

Read from SKILL.md and the folder at commit b60a52e. 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

    Ships script files (Python, from the files we listed), which the agent can run.

    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

Run Agentic Dse loads about 2.7k tokens when it runs, and up to ~6k if it reads all its reference files. Until then it costs about 72 tokens; SKILL.md has 1,325 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~72
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~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 Shinei-Nouzen-Arch/FPGA-Agent at commit b60a52e, republished under its GPL-2.0 licence (© Shinei-Nouzen-Arch). 1,325 words, ~2,652 tokens.

Download SKILL.mdSave it as .claude/skills/run-agentic-dse/SKILL.md (or your agent's skills folder). This skill also uses 23 other files; get the full folder from GitHub.
name
run-agentic-dse
description
Initialize, run, resume, and inspect FPGA HLS design-space exploration with Explorer, Exploiter, and Innovator workers. Also use for read-only requirement review, architecture advice, Pareto analysis, and convergence diagnosis without automatically launching experiments.

Agentic-DSE

Use capable-model judgment to choose evidence-backed experiments within the user's objective, numerical contract, validation policy, and budget. A request to explain or inspect does not authorize an experiment.

Roots and routing

  • Skill root is the directory containing this file: generic prompts, references, scripts, and synthetic tests are resources, not the active experiment.
  • Project root is the user's selected DSE project: benchmark inputs, runtime state, worker workspaces, results, and archives live there. Resolve both roots to absolute paths before acting; do not assume they coincide.
  • Read AGENTS.md for ownership and delegation rules. For initialization or execution also read references/contracts.md.
  • init req, run dse, and show pareto are natural-language intent labels, not shell commands. Keep the package directory named DSE-agent; its compatible invocation name is $run-agentic-dse.
IntentScope
Review requirements, suggest architecture, diagnose convergenceRead available inputs and relevant prompts; return analysis or proposals without writing state or running HLS
Initialize or prepare a runCreate missing, authorized project state and workspace inputs; no experiments unless requested
Run or continue DSEExecute the authorized round budget, including routine in-scope fixes and validation
Show status or ParetoRead state and reports; optional read-only HV calculation; no initialization or repair
Reset or switch benchmarkArchive existing state and evidence first; reset only the user-requested scope

Missing runtime files are not a reason to refuse read-only advice. State what can be established and which evidence is absent. Do not silently turn a diagnostic request into a repair.

Publication boundary

Keep project-specific designs, benchmark inputs, experiment records, learned knowledge, reports, input manifests, archives, and local environment details in the private project directory. This skill package does not bundle a project's knowledge base or target configuration.

A request to copy, update, or publish the skill authorizes generic skill resources, not disclosure of local development content. Review an explicit file allowlist before publication. Use synthetic examples and placeholders; publish project-derived material only when the user explicitly approves those specific artifacts for that destination. This boundary does not prevent authorized local experiments or read-only analysis.

Initialize or reconcile an authorized run

  1. Identify the benchmark from the request and project context. Support an existing benchmarks/<name>/ or legacy designs/<name>/ layout; do not rename it. Read its source, testbench, configuration, and objectives.json or spec.json. Preserve reference implementations, test vectors, interfaces, arithmetic behavior, and tolerances.
  2. Use prompts/req_parser.md with src/req_parser_schema.json. First resolve facts from the conversation and selected project. Distinguish blocking decisions from optional preferences. Ask at most three real blockers at a time, retaining the rest; uncertainty in an estimate is not an approval gate.
  3. Run the Parser and then prompts/architect.md sequentially, normally locally. Their outputs are proposals under tmp/<run_id>/; only Main promotes checked proposals into shared state.
  4. Main records one validation policy and execution budget for the assignment chain. A requested formal DSE run authorizes its normal synthesis, simulation, and implementation stages unless restricted by the user or host. An explicit implementation ban takes precedence. Do not ask again for stages already authorized; do not expand authority to hardware programming, external publication, installations, paid services, or semantic changes.
  5. For a new authorized run, create only missing runtime files, with consistent benchmark and run identity:
    • state/search_directive.json and state/architecture_decisions.json;
    • state/pareto_front.json and state/lineage.json as empty arrays;
    • state/agent_contributions.json as an empty object;
    • knowledge/learned/successful_configs.json and failure_cases.json as empty arrays, and learned_hints.json as an empty object;
    • results/, tmp/, and separate workspace/<role>/src and tb trees, seeded from the selected benchmark with a usable role-local config.cfg.
  6. Preserve existing state and user edits. Infer or migrate unambiguous legacy metadata without inventing validation. Reconcile missing files from existing evidence; do not erase a population merely because one file is absent. A conflicting active benchmark needs the requested switch/archive procedure, not silent replacement.
  7. Record target facts from the selected project or installed tools in private project state. Do not package a real project's platform profile as a public default. Missing optional HV configuration or architecture estimates need not block an otherwise executable run.
Show full SKILL.md (667 more words)Show less

Execute rounds

  1. Read the current directive, architecture decisions, population, lineage, and contributions. Validate their benchmark, policy, and numerical-contract consistency. Check required tools and input files without launching expensive work just to inspect status.
  2. Main selects parents from immutable, evidence-backed candidates and defines one bounded assignment per role. With zero parents, use three explicitly labeled seed assignments; with one parent, Innovator uses a single-parent seed variant. Only call an operation crossover when it actually has two parents.
  3. For each actual DSE round, create fresh Explorer, Exploiter, and Innovator workers using prompts/explorer.md, prompts/exploiter.md, and prompts/innovator.md. Include the shared references/worker-workflow.md, absolute input/output paths, identities, numerical contract, policy, allowed clocks, parents, goals, and total attempt budget. Batch roles if concurrency is limited; do not omit a role or start nested workers.
  4. Workers run only policy-permitted stages in their own workspaces. Default to three total attempts per assignment: initial attempt plus two retries, shared across all clocks, edits, and stages. Use a different explicit task budget when supplied.
  5. Wait for all three workers to finish. Main checks reports against the candidate input digest and stage receipts, functional pass evidence, clock and metric units, and the selected policy. An exit code or synthesis estimate alone is not formal acceptance.
  6. Before reusing any worker workspace, archive its result, source/header/test data, configuration, input manifest, stage receipts, and reports under a new round/candidate path. Use src/artifacts.py or an equivalent checked snapshot. Never overwrite an existing archive. Pareto and parent references must point to immutable archives, not mutable workspace files.
  7. Main alone updates state, lineage, contributions, and learned knowledge. Admit only fully validated formal successes to the formal Pareto population. Keep cosim-only results in a separate provisional population; do not promote them or mix their metrics into formal HV.
  8. If a fixed, benchmark-specific HV configuration is available, run src/hypervolume.py. Record the actual algorithm, configuration ID, population, reference point, result status, and value. Keep missing metrics as null; never substitute a platform limit or a guessed clock.
  9. Apply the stopping mode below. For the next authorized round, archive the previous round and retire its workers before creating fresh identities. No per-round reapproval is needed within the existing scope and budget.
  10. Report actual rounds, accepted/rejected/provisional candidates, best validated metrics, preserved artifacts, remaining failures, and the termination reason. Task completion and engineering success are separate: a requested cosim-only or fixed-budget run can finish without producing a formal feasible design.

Stopping and completion

  • Fixed rounds: run dse <benchmark> N means exactly N rounds unless a user stop, exhausted execution limit, unavailable essential capability, or authority/input blocker prevents continuation. Without N, run one round. A low HV improvement alone does not truncate a fixed-round request.
  • Until converged: requires a finite maximum-round budget. Use an existing project budget; if none exists, obtain that consequential limit before starting an open-ended run. The default criterion is three consecutive relative improvements below 2%, computed over comparable, valid, nonempty formal populations with the same HV configuration ID.
  • Compute relative improvement against the preceding positive HV. Missing, empty, invalid, zero-baseline, unavailable, or differently configured values do not count as low improvement. A decrease requires consistency/regression diagnosis, not a convergence claim.
  • When convergence cannot be measured, continue safe work within the authorized budget using available engineering evidence; report that convergence is undetermined.
  • Distinguish fixed_rounds_complete, converged, budget_exhausted, blocked, and user_stopped. Separately record whether there is a formal_feasible_point, provisional_only, or no_feasible_point. Do not call a plateau, failed run, or incomplete report set successful closure.

Status and recovery

Read only the evidence that exists. The HV helper returns structured unavailable/error states and does not install dependencies or write state. Its absence or missing optional numerical libraries must not hide the benchmark, completed rounds, available points, failures, or missing reports.

Use host-provided tools and respect their sandbox/approval decisions. If an essential command is denied, complete unaffected in-scope work and report the precise blocker. Preserve the best candidate and archive before any requested reset; never reset or modify an unrelated project or installed skill.

© Shinei-Nouzen-Arch, GPL-2.0. 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 23 other files (references) in DSE-agent of Shinei-Nouzen-Arch/FPGA-Agent.

  • SKILL.md
  • AGENTS.md
  • agent.md
  • agents/openai.yaml
  • evals/scenarios.json
  • prompts/architect.md
  • prompts/coding_style.md
  • prompts/exploiter.md
  • prompts/explorer.md
  • prompts/hardware_checklist.md
  • prompts/hls_tool_reference.md
  • prompts/innovator.md
  • prompts/req_parser.md
  • references/contracts.md
  • references/worker-workflow.md
  • src/artifacts.py
  • … and 8 more

Open the folder on GitHubat commit b60a52e

Compare with similar skills

Run Agentic Dse 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.

Run Agentic Dse compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Run Agentic Dse this skillShinei-Nouzen-Arch/FPGA-Agent180—~2.7kAutomated safety check: PassGPL-2.0
Vercel Composition Patternssupabase/supabase111k58 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 58 repos~726 tokens
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from Shinei-Nouzen-Arch/FPGA-Agent

All 10 skills in this repo
  • Vivado Debug

    Shinei-Nouzen-Arch/FPGA-Agent

    A skill your agent uses when the user needs help with Vivado in-system debugging, hardware programming, or debug core configuration.

    180 GitHub stars~4.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Vivado Analysis

    Shinei-Nouzen-Arch/FPGA-Agent

    A skill your agent uses when the user needs Vivado design analysis, timing report interpretation, or timing-closure diagnosis.

    180 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Vivado Constraints

    Shinei-Nouzen-Arch/FPGA-Agent

    A skill your agent uses when the user needs help writing XDC/SDC timing or physical constraints for Vivado FPGA designs.

    180 GitHub stars~3.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Vivado Impl

    Shinei-Nouzen-Arch/FPGA-Agent

    A skill your agent uses when the user needs Vivado implementation strategy selection or optimization.

    180 GitHub stars~3.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Vivado Sim

    Shinei-Nouzen-Arch/FPGA-Agent

    A skill your agent uses when the user needs help with Vivado simulation strategy, flow selection, and debugging.

    180 GitHub stars~2.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Vivado Synth

    Shinei-Nouzen-Arch/FPGA-Agent

    A skill your agent uses when the user needs help with Vivado synthesis strategy selection, synthesis attribute configuration, synthdesign option tuning, resource inference control…

    180 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Run Agentic Dse

What does Run Agentic Dse do?

Initialize, run, resume, and inspect FPGA HLS design-space exploration with Explorer, Exploiter, and Innovator workers. Run Agentic Dse is an agent skill from Shinei-Nouzen-Arch/FPGA-Agent. Initialize, run, resume, and inspect FPGA HLS design-space exploration with Explorer, Exploiter, and Innovator workers.

When should I use Run Agentic Dse?

Run Agentic Dse fits situations like: read-only requirement review; architecture advice; pareto analysis; convergence diagnosis without automatically launching experiments.

How do I install Run Agentic Dse in Claude Code?

Run `npx skills add Shinei-Nouzen-Arch/FPGA-Agent --skill run-agentic-dse -a claude-code`. Or copy the skill folder (DSE-agent in Shinei-Nouzen-Arch/FPGA-Agent) into .claude/skills/run-agentic-dse in your project. Claude Code loads it when a task matches its description.

How do I install Run Agentic Dse in Codex?

Run `npx skills add Shinei-Nouzen-Arch/FPGA-Agent --skill run-agentic-dse -a codex`. Or copy the skill folder (DSE-agent in Shinei-Nouzen-Arch/FPGA-Agent) into .agents/skills/run-agentic-dse in your project. Codex loads it when a task matches its description.

Can I use Run Agentic Dse 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 Shinei-Nouzen-Arch/FPGA-Agent --skill run-agentic-dse -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/run-agentic-dse, .gemini/skills/run-agentic-dse, .github/skills/run-agentic-dse and .opencode/skills/run-agentic-dse in your project.

What does Run Agentic Dse need to run?

Going by SKILL.md and its folder, Run Agentic Dse needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Run Agentic Dse 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 Run Agentic Dse 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 Run Agentic Dse use?

Run Agentic Dse is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Run Agentic Dse use?

About 2.7k tokens (SKILL.md is roughly 11k 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 3.4k tokens, read only when the agent opens those files.

What are the alternatives to Run Agentic Dse?

Skills that share tags, products or a category with Run Agentic Dse: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Run Agentic Dse?

Shinei-Nouzen-Arch (a GitHub user) maintains it in Shinei-Nouzen-Arch/FPGA-Agent, which has 180 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 5, 2026.

Source: Shinei-Nouzen-Arch/FPGA-Agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.