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

/printing-press-retro

@9e1a8d4
Run it yourself

Use when the user asks to retro, run a retrospective, file findings, or improve the Printing Press after a printed-CLI run. Trigger phrases: "retro", "retrospective", "what went wrong", "improve the press", "post-mortem", "lessons learned", "what can we improve", "file a retro", "submit findings". Do not use for printed-CLI polish or a single-CLI fix.

Use this Skill: https://skilld.dev/gh/mvanhorn/cli-printing-press/printing-press-retro

Nothing lands on disk. Nothing to clean up.

Fork this Skill

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

referencesartifact-packaging.md

≈1.8k tokens on demand. Your agent reads this file only when SKILL.md points to it.

Artifact Packaging and Upload

Read this file during Phase 6, Step 1 (packaging) and Step 3 (uploading).

Steps 1-4 run during Phase 6 Step 1 to prepare artifacts locally. Step 5 runs during Phase 6 Step 3 after the user confirms they want to submit. Step 6 (failure handling) runs if Step 5 encounters errors. Step 7 (cleanup) runs at the very end of Phase 6, after everything else is done.

Cardinal rule: Never modify the user's source directories. All operations work on temporary copies. If anything fails, the user's manuscripts and library are untouched.

Step 1: Create staging directory

STAGING_DIR=$(mktemp -d)
STAGING_MANUSCRIPTS="$STAGING_DIR/manuscripts"
STAGING_CLI_SOURCE="$STAGING_DIR/cli-source"
echo "Staging artifacts in $STAGING_DIR"

Step 2: Copy artifacts to staging

Copy the manuscript run directory:

mkdir -p "$STAGING_MANUSCRIPTS"
cp -r "$RUN_DIR/." "$STAGING_MANUSCRIPTS/"

Copy the CLI source if available. Skip if CLI_DIR is empty (manuscripts-only mode):

if [ -n "$CLI_DIR" ] && [ -d "$CLI_DIR" ]; then
  mkdir -p "$STAGING_CLI_SOURCE"
  if command -v rsync >/dev/null 2>&1; then
    rsync -a \
      --exclude="$CLI_NAME" \
      --exclude="vendor/" \
      --exclude="go.sum" \
      --exclude=".git/" \
      --exclude="*.test" \
      --exclude="*.exe" \
      "$CLI_DIR/" "$STAGING_CLI_SOURCE/"
  else
    cp -r "$CLI_DIR/." "$STAGING_CLI_SOURCE/"
    rm -f "$STAGING_CLI_SOURCE/$CLI_NAME"
    rm -rf "$STAGING_CLI_SOURCE/vendor" "$STAGING_CLI_SOURCE/.git"
    rm -f "$STAGING_CLI_SOURCE/go.sum"
    find "$STAGING_CLI_SOURCE" \( -name "*.test" -o -name "*.exe" \) -delete 2>/dev/null
  fi
else
  echo "No CLI source directory available. Packaging manuscripts only."
  STAGING_CLI_SOURCE=""
fi

Step 3: Scrub secrets

Read and apply references/secret-scrubbing.md on the staging copies. The scrub file expects $STAGING_MANUSCRIPTS and $STAGING_CLI_SOURCE to be set.

If the post-scrub verification reports unresolved secrets, do not proceed with upload. Save the zips locally and tell the user to review manually.

Initialize the upload gate before running the scrub, so skipped or failed verification cannot accidentally enable a public upload:

SCRUB_VERIFIED=false

After applying all scrub layers, run the post-scrub verification block from references/secret-scrubbing.md. Record success only when that block completes with no unresolved findings (FINAL_CHECK=false):

if [ "${FINAL_CHECK:-true}" = false ]; then
  SCRUB_VERIFIED=true
else
  echo "Upload blocked: post-scrub verification found unresolved findings or did not run."
fi

Step 4: Zip artifacts

MANUSCRIPTS_ZIP="$STAGING_DIR/$API_SLUG-manuscripts.zip"
CLI_SOURCE_ZIP=""

(cd "$STAGING_MANUSCRIPTS" && zip -r "$MANUSCRIPTS_ZIP" . -x "*.DS_Store") 2>/dev/null
echo "Manuscripts zip: $(du -h "$MANUSCRIPTS_ZIP" | cut -f1)"

if [ -n "$STAGING_CLI_SOURCE" ] && [ -d "$STAGING_CLI_SOURCE" ]; then
  CLI_SOURCE_ZIP="$STAGING_DIR/$API_SLUG-cli-source.zip"
  (cd "$STAGING_CLI_SOURCE" && zip -r "$CLI_SOURCE_ZIP" . -x "*.DS_Store") 2>/dev/null
  echo "CLI source zip: $(du -h "$CLI_SOURCE_ZIP" | cut -f1)"
fi

Step 5: Upload to catbox.moe

Upload each artifact and capture the returned URL:

MANUSCRIPTS_URL=""
CLI_SOURCE_URL=""
RETRO_DOC_URL=""
UPLOAD_FAILED=false

if [ "${SUBMISSION_CONFIRMED:-false}" != "true" ] || [ "${SCRUB_VERIFIED:-false}" != "true" ]; then
  echo "REFUSING upload: explicit submission consent and successful secret-scrub verification are both required."
  UPLOAD_FAILED=true
else

catbox_upload() {
  # $1 = path to file. Prints the URL on success, returns non-zero on failure.
  local response
  response=$(curl -sf -F "reqtype=fileupload" -F "fileToUpload=@$1" https://catbox.moe/user/api.php 2>/dev/null) || return 1
  if printf '%s' "$response" | grep -Eq '^https://files\.catbox\.moe/[A-Za-z0-9._-]+$'; then
    printf '%s' "$response"
  else
    return 1
  fi
}

# Upload retro document (raw .md — viewable directly in browser)
if RETRO_DOC_URL=$(catbox_upload "$RETRO_PROOF_PATH"); then
  echo "Retro document uploaded: $RETRO_DOC_URL"
else
  echo "WARNING: Failed to upload retro document to catbox.moe."
  RETRO_DOC_URL=""
  UPLOAD_FAILED=true
fi

# Upload manuscripts zip
if MANUSCRIPTS_URL=$(catbox_upload "$MANUSCRIPTS_ZIP"); then
  echo "Manuscripts uploaded: $MANUSCRIPTS_URL"
else
  echo "WARNING: Failed to upload manuscripts to catbox.moe."
  MANUSCRIPTS_URL=""
  UPLOAD_FAILED=true
fi

# Upload CLI source (only if it was packaged)
if [ -n "$CLI_SOURCE_ZIP" ] && [ -f "$CLI_SOURCE_ZIP" ]; then
  if CLI_SOURCE_URL=$(catbox_upload "$CLI_SOURCE_ZIP"); then
    echo "CLI source uploaded: $CLI_SOURCE_URL"
  else
    echo "WARNING: Failed to upload CLI source to catbox.moe."
    CLI_SOURCE_URL=""
    UPLOAD_FAILED=true
  fi
else
  echo "No CLI source to upload (manuscripts-only mode)."
fi

fi

Step 6: Handle upload failure (R15)

If either upload failed:

if [ "$UPLOAD_FAILED" = true ]; then
  # Preserve local zips for manual attachment
  LOCAL_ZIP_DIR="$RUN_DIR/proofs"
  cp "$MANUSCRIPTS_ZIP" "$LOCAL_ZIP_DIR/" 2>/dev/null
  cp "$CLI_SOURCE_ZIP" "$LOCAL_ZIP_DIR/" 2>/dev/null
  echo ""
  echo "Some artifacts could not be uploaded to catbox.moe."
  echo "Local copies saved to: $LOCAL_ZIP_DIR/"
  echo "You can upload them manually or attach them to the GitHub issue."
fi

Step 7: Cleanup

Called by the SKILL.md at the end of Phase 6, after issue creation, local saves, and presenting results are all complete. Do not call this immediately after zipping — the staging folder must stay alive for user review and upload.

rm -rf "$STAGING_DIR"

If cleanup fails (permissions, etc.), it's a temp directory — the OS will clean it up eventually. Do not let cleanup failure block the rest of the workflow.

Variables expected by this reference

Variable Set by Contains
$RUN_DIR SKILL.md Phase 1 Full path to the manuscript run directory
$CLI_DIR SKILL.md Phase 1 Full path to the CLI library directory
$CLI_NAME SKILL.md guard rails Binary name (e.g., cal-com-pp-cli)
$API_SLUG SKILL.md guard rails API slug (e.g., cal-com)
$API_KEY_VALUE User session (optional) The API key if provided during generation

Variables produced by this reference

Variable Contains
$RETRO_DOC_URL catbox URL for retro .md file (viewable in browser), or empty if upload failed
$MANUSCRIPTS_URL catbox URL for manuscripts zip, or empty if upload failed
$CLI_SOURCE_URL catbox URL for CLI source zip, or empty if upload failed
$SUBMISSION_CONFIRMED true only after the user selected Submit in Phase 6 Step 2; uploads are refused otherwise
$SCRUB_VERIFIED true only when Step 3's post-scrub verification completed with no unresolved findings; uploads are refused otherwise
$UPLOAD_FAILED true if any upload failed, false otherwise
$MANUSCRIPTS_ZIP Local path to manuscripts zip (in staging, deleted after cleanup)
$CLI_SOURCE_ZIP Local path to CLI source zip (in staging, deleted after cleanup)

Source: SKILL.md on GitHub

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.

1 warning2mo3 checks · Risk SAFE
  • Gen Agent Trust Hub2mo

    The skill performs automated retrospectives and logs issues to a GitHub repository. It includes data exposure risks due to uploading project artifacts to a public anonymous file-sharing service, along with an indirect prompt injection surface from parsing raw session transcripts.

  • Socket2mo

    1 alert: gptAnomaly

  • Snyk2mo

    Risk: LOW · No issues

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

Last checked against GitHub 19 hours ago.

Activeupdated 3 months ago
What it can do
Runs commands Reads files Edits files
version
0.1.0
created_by
user
All 7 allowed tools
BashReadGlobGrepWriteAgentAskUserQuestion

README badge

README badge for mvanhorn/cli-printing-press/printing-press-retro