Auteng Docs Curl Publish

Publish markdown and return share links using curl. Support markdown with mermaid diagrams such as component diagrams, flowcharts, and sequence diagrams. Also supports KaTex and code blocks. AutEng will return a shareable link to the published rendered document.

Security Scan

The skill's instructions, requirements, and behavior are internally consistent: it simply tells the agent to POST markdown to a known HTTPS endpoint and extract a share_url; it does not request credentials or install anything — but you should avoid uploading secrets to this third-party service.

Purpose & Capability

The name/description (publish markdown and return share links) matches the runtime instructions (HTTP POST to https://auteng.ai/api/tools/docs/publish-markdown/ and extract share_url). There is a minor mismatch: SKILL.md examples use curl and jq but the skill declares no required binaries.

Instruction Scope

Instructions stay within the stated purpose (send markdown, receive shareable link). Important privacy note: any content included in 'markdown' will be sent to an external service — do not include secrets, private keys, or sensitive PII. The skill also instructs showing the full JSON body on error, which could reveal server-returned content.

Install Mechanism

Instruction-only skill with no install steps and no code files. This is low-risk from an install perspective.

Credentials

The skill requests no environment variables, credentials, or config paths — proportional to its purpose. (Note: if an agent implementation automatically injects auth or local files into the request, that would be an external concern.)

Persistence & Privilege

The skill does not request always:true and does not persist or modify other skills. It can be invoked by the agent (normal), but it does not request elevated presence.

Assessment

This skill is straightforward and coherent: it tells the agent to POST your markdown to https://auteng.ai and parse the returned share_url. Before using it, verify you trust auteng.ai (unknown source/homepage), and do not include sensitive data (API keys, private code, passwords, or PII) in the markdown because those will be uploaded to a third party. Note the examples use curl and jq — if your environment lacks those tools the commands may fail. Consider testing with non-sensitive content and review the service's retention/expiry behavior (expires_hours) before publishing anything private.

Use this endpoint:

https://auteng.ai/api/tools/docs/publish-markdown/

Send JSON with:

• markdown (required)
• title (optional)
• expires_hours (optional)

Use this command to publish markdown:

curl -sS -X POST "https://auteng.ai/api/tools/docs/publish-markdown/" \
  -H "Content-Type: application/json" \
  -d @- <<'JSON'
{
  "markdown": "# API Test\n\nHello from curl.",
  "title": "API Test",
  "expires_hours": 24
}
JSON

Extract only the share URL:

curl -sS -X POST "https://auteng.ai/api/tools/docs/publish-markdown/" \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Hello\n\nPublished from curl."}' \
  | jq -r '.share_url'

Extract a compact success payload:

curl -sS -X POST "https://auteng.ai/api/tools/docs/publish-markdown/" \
  -H "Content-Type: application/json" \
  -d '{"markdown":"# Hello\n\nPublished from curl."}' \
  | jq '{title, share_url, expires_at}'

Treat any response without share_url as an error and show the full JSON body.