AIWriter Skill

Path: /docs/skills/aiwriter

AIWriter is the official GeoWriter skill for article generation.

https://github.com/geowriter/aiwriter

It wraps the GeoWriter Integration API into a practical workflow for teams and agents that want faster adoption with fewer implementation details.

What the Skill Handles

  • Interactive .env setup
  • POST /api/v1/documents/create for task submission
  • GET /api/v1/documents/progress/{id} for polling
  • GET /api/v1/documents/detail/{id} for final retrieval
  • Markdown or JSON output generation

Typical Setup Flow

  1. Prepare your GeoWriter base URL and API key.
  2. Configure GW_API_BASE_URL and GW_API_KEY.
  3. Run the article creation command.
  4. Let the skill poll until the job is complete.
  5. Consume the generated Markdown or JSON output.

Why Start with the Skill

  • It removes most of the repetitive orchestration work.
  • It standardizes polling, retrieval, and output handling.
  • It is better suited to operators, agents, and repeatable workflows than raw API calls.

When to Use the API Directly

If you need full control over orchestration, publishing, retries, or platform-specific behavior, use the Post API directly.