Index of every page on this site: llms.txt
All skills
anomalyco avatar

/self-iteration

@9ea31dc
by Anomalyanomalyco/browser-control475 stars
32
Run it yourself

Dogfood a project-owned tool in a realistic user flow and evaluate the agent experience. Use when the user asks to dogfood or self-iterate, or when testing or evaluating a tool built by this project.

Use this Skill: https://skilld.dev/gh/anomalyco/browser-control/self-iteration

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈54 tokens for metadata: the name and description. ≈433 when used: this file.

Description uses 2.7% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈216 characters, or 2.7%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Self-Iteration

Run a field test: use the tool to complete a real task for the user while observing the agent experience. The task, not the evaluation, remains the primary goal.

Workflow

  1. Agree on a realistic task and its safety boundary. If the user has no task, suggest one that exercises the tool's main workflow without destructive or irreversible actions.

Completion criterion: the user and agent share a concrete task, expected outcome, and boundary for actions requiring confirmation.

  1. Perform the task through the public interface an agent is expected to use. Prefer the shortest natural path; do not manufacture edge cases or switch to internal interfaces merely to make progress.

While working, note only observed evidence:

  • extra round trips or context needed to choose the next action
  • slow operations or avoidable waiting
  • confusing names, shapes, defaults, errors, or documentation
  • failures, missing capabilities, and recovery quality
  • behavior that made the flow unusually direct or token-efficient

Completion criterion: the user's task is complete or a specific blocker has been identified, and each finding is tied to an observed step in the flow.

  1. Give the user the task result first. Then report the field-test verdict:
  • bugs, with reproduction evidence and impact
  • concrete improvement suggestions, separated from bugs
  • strengths worth preserving
  • an explicit "went well" verdict when no change is justified

Do not modify the tool in response to findings during the field test. Surface findings first so the user can choose what to implement.

Completion criterion: the user receives both the useful task outcome and a concise, evidence-based verdict on the tool experience.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts3mo3 checks · Risk SAFE
  • Gen Agent Trust Hub3mo

    The skill is a collection of natural language instructions providing a workflow for testing and evaluating tools. It contains no executable code or scripts and includes explicit guidance on establishing safety boundaries before performing tasks.

  • Socket3mo

    No alerts

  • Snyk3mo

    Risk: LOW · No issues

Signed by skilld at 9ea31dc. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last week.

Activeupdated 4 months ago

README badge

README badge for anomalyco/browser-control/self-iteration