Skip to content

Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-seo-programmatic

saas-seo-programmatic

Unverified

Architect programmatic SaaS SEO directories/templates with >=40% unique content gates.

FileKindSize
SKILL.mdskill md3.6 KB
---
name: saas-seo-programmatic
description: "Architect programmatic SaaS SEO directories/templates with >=40% unique content gates."
argument-hint: "[url or plan]"
user-invocable: true
---

<!-- Generated from .claude/skills by scripts/sync-agent-skills.py. -->

## Running this workflow on this client

Run commands from the project root (use Git Bash on Windows if `bash` points to an unavailable WSL distro). Shared studio files live in `.claude/`; follow `.agents/PORTABLE-RUNTIME.md` and `.claude/docs/config-resolution.md` for client tools, delegation, and approval rules.

Run `bash .claude/hooks/yaml-helper.sh resolve_config --keys locale,review_mode,automation` and use its output below.

Resolved above — use as-is; `--review` overrides `review_mode` for this run.

# Programmatic SaaS SEO

> **Locale & User Profile**: Match `locale` (`pt-BR` → natural Brazilian Portuguese questions/options, overriding English examples; `en` → English) and `user_profile` (`founder` → plain business language with `(Recomendado)` first, zero tech jargon; `developer` → technical). Keep code/tests in English.


Architects and audits high-volume programmatic landing pages for SaaS products (integration directories, tool calculators, template libraries, industry use-cases).

---

## 1. Proven SaaS Programmatic Archetypes

1. **Integration Directory**: `/integrations/[slug]`
   - E.g. "Connect Basinfy with Slack", "Basinfy for GitHub".
   - Structured fields: Authentication protocol (OAuth/API key), supported webhooks, triggers, sync frequencies, code snippets.
2. **Tools & Calculators**: `/tools/[slug]`
   - Free interactive calculators solving specific pain points (e.g. "SaaS Runway Calculator", "Stripe Fee Estimator").
3. **Template Library**: `/templates/[slug]`
   - Ready-to-use workflows, dashboard setups, prompt packs, or SQL schemas.
4. **Glossary / Developer Reference**: `/glossary/[term]`
   - Authoritative definitions of industry-specific terms linking back to core product features.

---

## 2. Thin Content & Scaled Content Abuse Safeguards

To prevent Google manual actions (under the March 2024 / 2025 Scaled Content Abuse policy):

| Gate Metric | Threshold | Operational Action |
|---|---|---|
| **Unique Content Ratio** | `< 40%` | ⚠️ **FLAG & REWORK**: Reject "mad-libs" variable swapping |
| **Minimum Unique Content** | `< 30%` | 🛑 **HARD STOP**: Do not publish, risk of sitewide penalty |
| **Word Count Minimum** | `< 300 words` | ⚠️ **WARN**: Insufficient value, requires supplementary data |
| **Batch Release Size** | `50 - 100 pages` | Progressive rollout with 2-3 weeks indexing verification |
| **Unjustified Volume** | `500+ pages` | 🛑 **HARD STOP**: Requires explicit user confirmation |

### Standalone Value Rule:
Every generated programmatic page must pass the test: *"Would this page provide tangible standalone value to a human user even if no other pages in the directory existed?"*

---

## 3. Next.js 14+ Implementation Pattern

```typescript
// app/integrations/[slug]/page.tsx
import { Metadata } from 'next';
import { notFound } from 'next/navigation';
import { getIntegrationBySlug } from '@/lib/integrations';

export async function generateMetadata({ params }: { params: { slug: string } }): Promise<Metadata> {
  const item = await getIntegrationBySlug(params.slug);
  if (!item) return {};

  return {
    title: `${item.name} Integration for Basinfy | Automate Workflows`,
    description: `Connect ${item.name} with your cloud architecture in minutes. Webhooks, real-time sync, and enterprise security.`,
    alternates: {
      canonical: `https://example.com/integrations/${params.slug}`,
    },
  };
}
```
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall