felo-landingpage
Generate landing pages/webpages with the Felo Landing Page Task API in Claude Code. Use when users ask to create/make/generate a landing page, marketing page, single-page website, AI webpage, HTML page result, or when explicit commands like /felo-landingpage are used. Handles API key check, task creation, polling shared task history, and final ai_page_html output.
How do I install this agent skill?
npx skills add https://github.com/felo-inc/felo-skills --skill felo-landingpageIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
The skill allows landing page generation but is vulnerable to command injection because user prompts are directly interpolated into shell commands. It also uses behavioral directives to bypass conversational logic and communicates with vendor-owned API endpoints.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Felo Landing Page Skill
When to Use
Trigger this skill for requests about creating generated webpages:
- Create/generate a landing page from a topic, product, feature, or campaign brief
- Turn a marketing description into a shareable single-page website
- Build an AI webpage and return the final hosted HTML result URL
- Generate a web page directly without follow-up questions when the user asks for immediate output
Trigger keywords:
- Chinese prompts about landing pages or webpages: 着陆页, 落地页, 官网页, 单页网站, 网页, HTML 页面
- English: landing page, marketing page, single-page website, webpage, AI page, HTML page
- Explicit commands:
/felo-landingpage, "use felo landing page"
Do NOT use this skill for:
- Presentation/PPT generation (use
felo-slides) - Mindmap generation (use
felo-mindmap) - Real-time information lookup only (use
felo-search) - Editing local website source files unless the user explicitly asks for local code changes
Setup
1. Get API key
- Visit felo.ai
- Open Settings -> API Keys
- Create and copy your API key
2. Configure environment variable
Linux/macOS:
export FELO_API_KEY="your-api-key-here"
Windows PowerShell:
$env:FELO_API_KEY="your-api-key-here"
How to Execute
Use Bash tool commands and follow this workflow exactly.
Step 1: Precheck API key
if [ -z "$FELO_API_KEY" ]; then
echo "ERROR: FELO_API_KEY not set"
exit 1
fi
If the key is missing, stop and return setup instructions.
Step 2: Run Node Script (create + poll)
Use the bundled script (no jq dependency):
node felo-landingpage/scripts/run_landingpage_task.mjs \
--query "USER_PROMPT_HERE" \
--interval 10 \
--max-wait 1800 \
--timeout 60
For best results, include a direct-generation instruction in the query when the user has not provided one:
In all cases, generate the webpage directly and do not ask any follow-up questions.
To resume polling an existing task without creating a duplicate landing page:
node felo-landingpage/scripts/run_landingpage_task.mjs \
--task-id "TASK_ID_HERE" \
--interval 10 \
--max-wait 1800
Script behavior:
- Creates task via
POST https://openapi.felo.ai/v2/landing_page - Polls via
GET https://openapi.felo.ai/v2/tasks/{task_id}/historical - Treats
COMPLETED/SUCCESSas success terminal (case-insensitive) - Treats
FAILED/ERROR/EXPIRED/CANCELED/CANCELLEDas failure terminal - Stops polling immediately on terminal status
- Prints
ai_page_htmlon success - Keeps
ppt_biz_idandppt_urlin JSON output because the historical response currently reuses the PPT history structure
Optional debug output:
node felo-landingpage/scripts/run_landingpage_task.mjs \
--query "USER_PROMPT_HERE" \
--interval 10 \
--max-wait 1800 \
--json \
--verbose
This outputs structured JSON including:
task_idtask_statusai_page_htmlppt_biz_idppt_urlerror_message
Step 3: Return structured result
On success, return:
ai_page_htmlimmediately (script default output)- if
--jsonis used, also includetask_id, terminal status, and optional metadata
Output Format
Use this response structure:
## Landing Page Generation Result
- Task ID: <task_id>
- Status: <status>
- HTML URL: <ai_page_html>
- PPT Biz ID: <ppt_biz_id or N/A>
- PPT URL: <ppt_url or N/A>
Error format:
## Landing Page Generation Failed
- Error Type: <error code or category>
- Message: <readable message>
- Suggested Action: <next step>
Open API Workflow
Use only the public Open API endpoints:
- Create task:
POST /v2/landing_page - Read
data.task_id - Poll result:
GET /v2/tasks/{task_id}/historical - Continue polling while
task_status == RUNNINGor another non-terminal status - When
task_status == COMPLETED, usedata.ai_page_htmlas the final webpage result URL
Authentication uses the user's Felo API key:
Authorization: Bearer <user_api_key>
Historical lookup currently reuses the shared task history shape, so ppt_biz_id and ppt_url may still appear alongside ai_page_html.
Error Handling
Known/expected failures:
INVALID_API_KEYor HTTP 401: key invalid or revoked- Create task response missing
task_id: API shape changed or task creation failed - Completed task missing
ai_page_html: query history again with--task-id, or report the task ID - Timeout reached: return last known status and the
task_idso the user can resume later
Timeout handling:
- If timeout is reached, return the last known status and instruct the user to retry later
- Include
task_idso the user can query again - To resume a timed-out task, use
--task-idinstead of--queryto avoid creating a duplicate landing page
Important Notes
- Always execute this skill when user intent is landing page or generated webpage creation.
- Always return
task_idso follow-up queries can continue from the same task. - Do not claim completion without a terminal status.
- Use
ai_page_htmlas the final result;ppt_urlis legacy/shared history metadata, not the landing page output. - Keep API calls minimal: create once, then poll.
References
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/felo-inc/felo-skills/felo-landingpage">View felo-landingpage on skillZs</a>