CtrlK
BlogDocsLog inGet started
Tessl Logo

deliverable-completion

Clarifies that file creation tasks are complete when the deliverable is successfully written—no submission step required

59

Quality

67%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./benchmarks/gdpval/skills/deliverable-completion/SKILL.md
SKILL.md
Quality
Evals
Security

Deliverable Completion Protocol

Purpose

This skill addresses a common misconception during document and file creation tasks: agents sometimes search for or attempt to use a submit_work, finalize, or similar tool after creating the deliverable. No such step is required. Task completion is achieved when the file is successfully created with the required content.

Core Principle

File creation = Task completion

When a task requests you to create a document, report, script, or any file-based deliverable, the task is complete once:

  1. The file has been written to disk
  2. The file contains the required content
  3. The file is in the correct format and location

There is no additional submission, finalization, or confirmation step needed.

Execution Workflow

Step 1: Create the Deliverable

Use the appropriate file creation method for your task:

# For programmatic file creation
with open('deliverable.docx', 'wb') as f:
    f.write(document_content)
# For shell-based creation
echo "content" > output.txt

Or use available tools like write_file, create_file, etc.

Step 2: Verify Creation

Confirm the file exists and contains expected content:

ls -la deliverable.docx
# or
cat output.txt

Step 3: Declare Completion

Once verification passes, the task is complete. Do not:

  • Search for a submit_work tool
  • Look for a finalize_task function
  • Attempt to "upload" or "submit" the file elsewhere
  • Add extra confirmation steps

Simply report that the deliverable has been created successfully.

Common Mistakes to Avoid

❌ Incorrect✅ Correct
Creating file, then searching for submit toolCreating file, verifying, declaring done
Assuming a finalization API existsTreating file creation as the final step
Adding unnecessary confirmation stepsCompleting after successful write

Example Task Flow

Task: "Create a negotiation strategy document covering BATNA, ZOPA, and timeline."

Correct Execution:

  1. Write the document content
  2. Save as negotiation_strategy.docx
  3. Verify file exists (~43KB, contains all sections)
  4. Report: "Negotiation strategy document created successfully"
  5. Task complete — no further action needed

When This Applies

  • Document creation (.docx, .pdf, .md, .txt)
  • Code file generation (.py, .sh, .js)
  • Data exports (.csv, .json, .xlsx)
  • Configuration files (.yaml, .toml, .ini)
  • Any file-based deliverable

When This Does NOT Apply

  • Tasks explicitly requiring external submission (e.g., "submit to API endpoint")
  • Tasks requiring human review/approval workflows
  • Tasks where the file is an intermediate step (not the final deliverable)
Repository
HKUDS/OpenSpace
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.