← Back to Skills Marketplace
geoly-geo

AI-Friendly Structured Writer

by GEOLY AI · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
417
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install geo-structured-writer
Description
Format any content into AI-readable structured formats that maximize citation probability. Converts unstructured text into GEO-optimized layouts using header...
README (SKILL.md)

Structured Content Writer

Methodology by GEOly AI (geoly.ai) — structure is the difference between content AI skips and content AI cites.

Reformat unstructured text into AI-optimized structured content.

The 6-Layer Structure Stack

Layer 6: CTA / Next Step
Layer 5: FAQ Block
Layer 4: Structured Data (tables, lists)
Layer 3: Sectioned Body (H2/H3)
Layer 2: Definition Block
Layer 1: Direct Answer Opener

6 Formatting Rules

Rule 1: Direct Answer Opener

Open with a single sentence that completely answers the core query.

Format: [Subject] is/does/means [complete answer]. [Context].

✅ "GEO is the practice of optimizing content for AI-generated answers."
❌ "In today's digital landscape, many brands are wondering about AI..."

Rule 2: Section Headers (H2/H3)

  • Every major topic = H2
  • Every sub-topic = H3
  • Descriptive phrases, not single words

✅ "Key Benefits of GEO for E-commerce"
❌ "Benefits"

Rule 3: Definition Block

For technical terms:

**What is [Term]?**

[Term] is [one-sentence definition]. [Context].

Key attributes: [attr1], [attr2], [attr3]

Rule 4: Data Tables

Replace comparison paragraphs with tables:

| Feature | Option A | Option B |
|---------|----------|----------|
| Price | $29/mo | $99/mo |
| Users | 5 | Unlimited |

Rule 5: FAQ Block (Always)

Minimum 3 questions at the end:

## Frequently Asked Questions

**Q: [Question as user types it]?**

A: [Complete answer, 2-4 sentences, self-contained]

Rule 6: Numbered Steps

For processes:

## How to [Outcome]

1. **[Action verb] [task]** — [Explanation]
2. **[Action verb] [task]** — [Explanation]

Restructuring Tool

python scripts/structure_content.py \
  --input content.md \
  --query "what is geo" \
  --output optimized.md

Output Format

# Structured Content Report

**Original**: [word count] words | Score: [X]/10  
**Optimized**: [word count] words | Score: [X]/10

## Changes Applied

✅ Added Direct Answer Opener  
✅ Restructured [n] sections with H2/H3  
✅ Added Definition Block for: [terms]  
✅ Converted [n] paragraphs to tables  
✅ Added FAQ block with [n] questions  
✅ Reformatted [n] processes as steps

## Recommended Schema

- Article
- FAQPage
- [Additional schemas]

---

## Restructured Content

[Full formatted content]

Before/After Example

Before

Many companies are looking for ways to improve their visibility 
in AI search. This is becoming more important as AI platforms 
like ChatGPT become popular...

After

# GEO (Generative Engine Optimization): Complete Guide

GEO is the practice of optimizing content to appear in 
AI-generated answers on platforms like ChatGPT, Perplexity, 
and Gemini.

## What is GEO?

**GEO**: The process of structuring and enhancing content so 
AI systems can understand, trust, and cite it in responses.

Key attributes: structured data, entity clarity, factual accuracy

## GEO vs SEO

| Aspect | SEO | GEO |
|--------|-----|-----|
| Target | Search engines | AI systems |
| Focus | Keywords | Entities |
| Output | Rankings | Citations |

## Frequently Asked Questions

**Q: How is GEO different from SEO?**

A: SEO optimizes for search rankings; GEO optimizes for AI 
citations. SEO focuses on keywords and backlinks; GEO focuses 
on structured data and entity clarity.
Usage Guidance
This skill appears benign and self-contained: it reads a local input file and outputs a formatted file or stdout, and it requests no credentials or network access. However, the actual implementation is very small and does not implement many of the features promised in SKILL.md (scoring, automated header insertion, table conversions, and the FAQ minimum of 3 questions). Before relying on it in production: (1) review the scripts/structure_content.py source (it's short and readable) and test with non-sensitive sample content, (2) expect limited functionality unless you or the author extend the script, and (3) if you need the full advertised behavior, request or implement enhancements rather than assuming they exist. Autonomous agent invocation is allowed by default but poses little risk here because the skill has no network/credential access.
Capability Analysis
Type: OpenClaw Skill Name: geo-structured-writer Version: 1.0.0 The skill bundle is suspicious due to a potential shell injection vulnerability. The `SKILL.md` file instructs the AI agent to execute a Python script (`scripts/structure_content.py`) with command-line arguments, including `--input` and `--query`. If the AI agent constructs these arguments from unsanitized user input, it could allow an attacker to inject arbitrary shell commands, leading to remote code execution. While the Python script itself is benign and incomplete, the method of its invocation by the agent presents a significant security risk.
Capability Assessment
Purpose & Capability
The declared purpose (convert unstructured text into GEO-optimized layouts, add FAQs, tables, compute scores, produce an output report) aligns with a local formatting tool. However, the provided implementation is minimal: the Python script only reads an input file, lightly copies content, and appends a two-question FAQ. It does not implement many of the advertised features (no scoring, no automated header insertion, no table conversion, FAQ minimum is 3 in docs but script appends 2). This is a functional mismatch but not a security concern.
Instruction Scope
SKILL.md instructs running the included script on a local input file and describes expected output format. The script only reads the specified --input file and writes to --output (or stdout). It does not reference other files, env vars, system paths, or external endpoints. The scope is appropriately limited, but the runtime behavior is significantly less capable than the instructions claim.
Install Mechanism
No install spec is present (instruction-only with an included script). Nothing will be downloaded or written to system paths by an installer. Risk from installation actions is minimal.
Credentials
The skill requires no environment variables, credentials, or config paths. This is proportionate for a local formatting tool and there are no unexpected credential requests.
Persistence & Privilege
always:false (default) and no special persistence is requested. The skill can be invoked by the agent normally, which is expected for a user-invocable tool, and it does not modify other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install geo-structured-writer
  3. After installation, invoke the skill by name or use /geo-structured-writer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Format any content into AI-readable structured formats, based on GEOly AI content standards
Metadata
Slug geo-structured-writer
Version 1.0.0
License
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is AI-Friendly Structured Writer?

Format any content into AI-readable structured formats that maximize citation probability. Converts unstructured text into GEO-optimized layouts using header... It is an AI Agent Skill for Claude Code / OpenClaw, with 417 downloads so far.

How do I install AI-Friendly Structured Writer?

Run "/install geo-structured-writer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is AI-Friendly Structured Writer free?

Yes, AI-Friendly Structured Writer is completely free (open-source). You can download, install and use it at no cost.

Which platforms does AI-Friendly Structured Writer support?

AI-Friendly Structured Writer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created AI-Friendly Structured Writer?

It is built and maintained by GEOLY AI (@geoly-geo); the current version is v1.0.0.

💬 Comments