Skip to content
cccskills
FreePublished on GitHub

spec-lite

Write a 5-part mini spec (goal, constraints, acceptance criteria, verification, done gate) before starting any multi-step, externally-delivered, or risky task. Triggers when: a request has 3+ steps, touches external delivery, or is easy to declare done too early. NOT for: single lookups, one-line edits, routine acks, or simple factual answers.

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (1)

  • SKILL.md2.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Spec Lite

Use this skill before starting non-trivial work.

When to Use

Trigger for work that is:

  • More than 10-15 minutes
  • Multi-step or cross-file
  • User-visible or externally delivered
  • Easy to mark done too early
  • Risky to execute without explicit checks

Do not use for tiny asks like:

  • one-line answers
  • simple lookups
  • obvious one-file edits
  • routine acknowledgements

Output Contract

Before execution, write a mini spec in 5 parts.

1. Goal

What exactly should exist or be true when the task is complete?

2. Constraints

What must be preserved or avoided? Examples:

  • no personal data exposure
  • no downtime
  • no schema change
  • no user-facing emoji

3. Acceptance Criteria

List 3-7 concrete checks. Use observable language.

Good:

  • morning briefing arrives at 07:00 Asia/Jerusalem
  • public repo contains SKILL.md only, no .context
  • message is in English and has no table

Bad:

  • works well
  • looks good
  • should be fine

4. Verification

How will you prove each criterion? Examples:

  • read the file
  • run the script
  • inspect the diff
  • verify recipient / timezone / target
  • confirm output shape

5. Done Gate

The task is not done until:

  • all acceptance criteria pass
  • risky outputs were verified
  • obvious follow-up was handled
  • status reported honestly

Execution Pattern

  1. Extract the request into the 5-part mini spec.
  2. Execute.
  3. Verify against the acceptance criteria.
  4. Only then report done.

Default Mini Spec Template

## Spec Lite
- Goal:
- Constraints:
- Acceptance Criteria:
  -
  -
  -
- Verification:
  -
  -
  -
- Done Gate:
  - all criteria checked

Recommended Checks by Task Type

Messaging

  • right recipient
  • right timing
  • right language/style
  • no duplicated send
  • no private data leak

Cron / automation

  • exact schedule
  • timezone
  • target channel / recipient
  • payload matches requested output
  • no stale old schedule left behind

Skill / repo changes

  • SKILL.md stays generic
  • no .context, data/, secrets, or private references
  • trigger description is clear
  • instructions are concise
  • public version matches local intent

Meeting prep / briefing

  • calendar matches today
  • overlaps called out explicitly
  • prep bullets are tied to real context
  • output is short enough to use live

Rule of Thumb

If the risk of a false "done" is meaningful, use Spec Lite.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ai-pa

Free

AI Personal Assistant network skill for multi-agent PA coordination. Use when: contacting another PA, coordinating with peer agents, scheduling meetings between owners, broadcasting messages to PA groups, or looking up contacts from the local PA directory. Reads contact data from data/pa-directory.json in the workspace.

The English summary is being prepared. Showing the original description.

netanel-abergel/pa-skills6Updated May 10, 2026

ai-pa

Free

Route and execute inter-PA coordination tasks in the OpenClaw multi-agent PA network. Triggers when: contacting another PA, passing a message between owners, broadcasting to a PA group, handling group lead/silence rules, or adding a new PA to the directory. NOT for: contact lookups (use contact-list skill), calendar invites (use meetings skill), or billing issues (use billing-monitor skill).

The English summary is being prepared. Showing the original description.

netanel-abergel/pa-skills6Updated May 10, 2026

ai-pa

Free

AI Personal Assistant network skill. Use when: contacting another PA, coordinating with peer agents, scheduling meetings between owners, broadcasting messages, looking up contacts from the local PA directory, or performing any cross-PA task. Reads contact data from data/pa-directory.json in the workspace. Does NOT contain hardcoded contact data — each PA maintains their own directory file.

The English summary is being prepared. Showing the original description.

netanel-abergel/pa-skills6Updated May 10, 2026

OpenClaw API gateway proxy for authenticated SaaS calls (100+ services in references/SERVICES.md). Use ONLY when making an HTTP request to a third-party service that requires the gateway's stored credentials. NOT for direct API calls with bearer tokens already in scope, NOT for monday.com (use monday-for-agents), NOT for WhatsApp (use heleni-whatsapp). Triggers: "call the X API", "fetch from <service>", "send to Slack via gateway", "use the gateway for".

The English summary is being prepared. Showing the original description.

netanel-abergel/pa-skills6Updated May 10, 2026

Automatically creates new skills from complex problem-solving sessions. Triggers at the end of multi-step tasks that required novel approaches, debugging sessions, or workflow creation. Use when: a task took 3+ tool calls, involved a non-obvious solution, or established a pattern likely to recur. Also triggers on: "create a skill from this", "save this as a skill", "this should be a skill".

The English summary is being prepared. Showing the original description.

netanel-abergel/pa-skills6Updated May 10, 2026

Monitor for API billing errors and alert the owner and admin immediately. Use when: an API billing error is detected, a peer PA reports a billing error, or during routine health checks. Handles detection, notification, and fallback model switching. Model-agnostic: works with any LLM provider (Anthropic, OpenAI, Google, etc.).

The English summary is being prepared. Showing the original description.

netanel-abergel/pa-skills6Updated May 10, 2026

See all skills by netanel-abergel

Report a problem with this skill