seo-engine

Category: Tools & Productivity | Uploader: agharsallah | Downloads: 0 | Version: v1.0（Latest）

Changelog: Source: GitHub https://github.com/agharsallah/seo-engine-skills

Directory Structure

Current level: Root

📁 references/
- 📄 seo_rules.json 970.9 KB
📁 rules/
- 📁 not_applicable/
  - 📄 DELETED_CONTENT_HTTP_ERROR.md 1.2 KB
  - 📄 DELETED_CONTENT_HTTP_ERROR.md:Zone.Identifier 25 B
  - 📄 MALWARE_HOSTING_DETECTION.md 3.8 KB
  - 📄 MALWARE_HOSTING_DETECTION.md:Zone.Identifier 25 B
  - 📄 URL_INSPECTION_TOOL_USER_ROLE.md 1.7 KB
  - 📄 URL_INSPECTION_TOOL_USER_ROLE.md:Zone.Identifier 25 B
- 📄 _template.md 1.2 KB
- 📄 AI_GENERATED_IMAGE_METADATA_MUST_CONTAIN_IPTC_DIGITAL_SOURCE_TYPE.md 1.6 KB
- 📄 AI_GENERATED_PRODUCT_DATA_MUST_BE_LABELED.md 2.1 KB
- 📄 AMP_PAGE_MUST_FOLLOW_SPEC.md 1.7 KB
- 📄 AVOID_ROBOTS_TXT_FOR_CANONICAL.md 1.4 KB
- 📄 BANNER_DATA_NOSNIPPET_PRESENT.md 1.5 KB
- 📄 CANONICAL_HEADER_ABSOLUTE_URL.md 1.4 KB
- 📄 CANONICAL_LINK_ABSOLUTE_URL.md 1.6 KB
- 📄 CANONICAL_LINK_IN_HEAD.md 1.7 KB
- 📄 CANONICAL_SELF_LINK.md 2.1 KB
- 📄 CANONICAL_SELF_REFERENCING.md 1.5 KB
- 📄 CHECK_HTTP_HTTPS_CONSISTENCY.md 1.2 KB
- 📄 CHECK_REL_CANONICAL_PRESENT.md 1.5 KB
- 📄 CHECK_URL_IN_SITEMAP.md 1.4 KB
- 📄 CLOAKING_DETECTION.md 3.8 KB
- 📄 CONSISTENT_CANONICAL_METHOD.md 2.5 KB
- 📄 CRAWLABLE_LINKS.md 1.1 KB
- 📄 DATA_NOSNIPPET_VALID_HTML.md 1.9 KB
- 📄 FAVICON_CRAWLABILITY.md 2.6 KB
- 📄 FAVICON_DIMENSIONS.md 1.9 KB
- 📄 FAVICON_URL_STABILITY.md 1.7 KB
- 📄 FILETYPE_INDEXABLE_CHECK.md 1.9 KB
- 📄 GOOGLEBOT_ACCESSIBLE.md 1.3 KB
- 📄 GOOGLEBOT_NOT_BLOCKED.md 1.3 KB
- 📄 HEAD_ALLOWED_ELEMENTS_MUST.md 1.9 KB
- 📄 HEAD_INVALID_ELEMENTS_ORDER_SHOULD.md 2.0 KB
- 📄 HEAD_SECTION_VALID_HTML.md 1003 B
- 📄 HEADING_HIERARCHY.md 974 B
- 📄 HIDDEN_TEXT_DETECTION.md 4.1 KB
- 📄 HREFLANG_TAGS_PRESENT.md 1.6 KB
- 📄 HTTP_STATUS_NOT_5XX.md 1.3 KB
- 📄 HYPHENS_IN_PATH.md 1.6 KB
- 📄 IMAGE_ALT_ATTRIBUTES.md 1.1 KB
- 📄 IMAGE_ALT_TEXT.md 1.1 KB
- 📄 IMAGE_NON_VECTOR_FORMAT.md 1.5 KB
- 📄 IMG_ALT_TEXT.md 1.5 KB
- 📄 KEYWORD_STUFFING_DETECTION.md 4.6 KB
- 📄 LINK_TEXT_DESCRIPTIVE.md 1.3 KB
- 📄 MAIN_HEADING_EXISTS.md 1.1 KB
- 📄 MALWARE_HOSTING_DETECTION.md 3.8 KB
- 📄 META_DESCRIPTION_PRESENT.md 1.4 KB
- 📄 META_ROBOTS_NOINDEX.md 1.6 KB
- 📄 NO_CLOAKING_DETECTED.md 1.8 KB
- 📄 NO_URL_FRAGMENTS.md 1.5 KB
- 📄 NOINDEX_HEADER_IMAGE_BLOCK.md 2.3 KB
- 📄 NOINDEX_META_TAG_PRESENT.md 1.8 KB
- 📄 NOINDEX_ON_LOGIN_PAGE.md 2.0 KB
- 📄 NOINDEX_RULE_ABSENT.md 1.7 KB
- 📄 PAGE_EXPERIENCE_DIVERSITY.md 2.2 KB
- 📄 PAGE_HTTP_200_STATUS.md 1.0 KB
- 📄 PAGE_INDEXABLE_CONTENT.md 1.1 KB
- 📄 PAGE_TITLE_EXISTS.md 1.1 KB
- 📄 PERCENT_ENCODING_NECESSARY.md 1.7 KB
- 📄 PHP_HEADERS_BEFORE_OUTPUT.md 2.2 KB
- 📄 REDIRECT_CHAIN_MAX_LENGTH.md 1.2 KB
- 📄 REDIRECT_USES_PERMANENT_STATUS.md 1.2 KB
- 📄 REL_ATTRIBUTE_ALLOWED_VALUES.md 1.9 KB
- 📄 REL_CANONICAL_PRESENT.md 1.4 KB
- 📄 RESOURCES_NOT_BLOCKED_BY_ROBOTS_TXT.md 2.2 KB
- 📄 RETRY_AFTER_HEADER_PRESENT_ON_503.md 1.6 KB
- 📄 ROBOTS_TXT_ALLOW_INDEXING_RULES.md 2.7 KB
- 📄 ROBOTS_TXT_DISALLOW_CRAWL.md 1.8 KB
- 📄 ROBOTS_TXT_IMAGE_BLOCK.md 1.7 KB
- 📄 ROBOTS_TXT_NOT_503.md 1.3 KB
- 📄 SEARCH_CONSOLE_VERIFICATION_PRESENT.md 1.4 KB
- 📄 SEO_SHOULD_EXPLAIN_FTP_CHANGES.md 1.7 KB
- 📄 SEO_SHOULD_NOT_LINK_TO_SEO.md 1.4 KB
- 📄 SITE_USES_HTTPS.md 1.1 KB
- 📄 SNEAKY_REDIRECT_DETECTION.md 3.4 KB
- 📄 TEMPORARY_BLOCKS_REMOVED.md 2.2 KB
- 📄 TEMPORARY_REDIRECT_302.md 1.3 KB
- 📄 TITLE_DESCRIPTIVE.md 1.1 KB
- 📄 TITLE_ELEMENT_PRESENT.md 1.3 KB
- 📄 TRUE_404_FOR_NOT_FOUND.md 1.3 KB
- 📄 URL_NO_EMAIL.md 1.3 KB
📁 scripts/
- 📁 cloaking_detection/
  - 📄 cloaking_detection.py 10.7 KB
  - 📄 README.md 1.5 KB
- 📁 favicon_dimensions/
  - 📄 favicon_dimensions.py 2.9 KB
  - 📄 README.md 1.2 KB
- 📁 hidden_text_detection/
  - 📄 hidden_text_detection.py 11.2 KB
  - 📄 README.md 3.8 KB
- 📁 keyword_stuffing_detection/
  - 📄 keyword_stuffing_detection.py 9.7 KB
  - 📄 README.md 5.7 KB
- 📁 page_experience_diversity/
  - 📄 page_experience_diversity.py 2.1 KB
  - 📄 README.md 1.3 KB
- 📁 prepare_input/
  - 📄 fetch_html.py 2.3 KB
  - 📄 fetch_lighthouse.py 6.0 KB
  - 📄 fetch_robots_txt.py 4.2 KB
  - 📄 fetch_sitemap.py 5.7 KB
  - 📄 README.md 3.8 KB
- 📁 resources_not_blocked_by_robots_txt/
  - 📄 README.md 962 B
  - 📄 resources_not_blocked_by_robots_txt.py 3.2 KB
- 📁 sneaky_redirect_detection/
  - 📄 README.md 8.2 KB
  - 📄 sneaky_redirect_detection.py 16.7 KB
- 📄 example.env 63 B
- 📄 pyproject.toml 346 B
- 📄 README.md 0 B
- 📄 uv.lock 81.6 KB
📄 .gitignore 364 B
📄 metadata.json 267 B
📄 README.md 3.7 KB
📄 SKILL.md 5.2 KB

SKILL.md

---
name: seo-engine
description: >-
  Expert SEO auditing skill for analyzing URLs, HTML source code, robots.txt, and sitemaps. 
  Evaluates on-page technical requirements, content basics, optimization signals, 
  and spam-policy compliance (cloaking, hidden text, keyword stuffing).
  Trigger phrases: "Run an SEO audit", "Analyze this URL for SEO", "Check my webpage for SEO issues", 
  "Is my robots.txt correct?", "Find cloaking or hidden text on this page".
license: MIT
metadata:
  author: Abderrahmen Gharsallah
  version: "1.1.0"
  category: auditing
  tags: [seo, audit, technical-seo, spam-detection]
---

# SEO Engine

The SEO Engine provides a standardized methodology for performing deterministic SEO audits using pre-defined rules and specialized diagnostic scripts. It handles everything from input preparation (fetching live data) to heuristic analysis of spam policies.

## Use Case
Perform technical SEO audits on websites or local files to ensure compliance with search engine guidelines and identify potential ranking issues.

## Triggering Logic
Use this skill when a user:
- Provides a website URL for analysis.
- Uploads/references HTML, robots.txt, or sitemap files.
- Asks for a "technical SEO check" or "audit".
- Specifically mentions SEO-related concerns like "indexability", "crawlability", or "spam signals".

## When NOT to use
- For general SEO strategy advice (e.g., "how do I rank for 'best laptops'?").
- For off-page SEO (backlink analysis, domain authority).
- For live performance monitoring (use Lighthouse/CWV tools).

---

## Workflow: SEO Audit Pipeline

Follow these steps sequentially. Do not skip validation gates.

### Step 1 — Input Identification & Preparation

1.  **Identify Input:** URL or local files (`@filename.html`).
2.  **Validation Gate (Input Type):** Ensure the input is a valid URL or supported file types (`.html`, `.htm`, `robots.txt`, `.xml`).
3.  **Prepare Live Data (if URL):**
    - `cd scripts/prepare_input/`
    - Run `python fetch_html.py <URL>`
    - Run `python fetch_robots_txt.py <URL>`
    - Run `python fetch_sitemap.py <URL>`
4.  **Validation Gate (File Presence):** Confirm that the fetched files (or provided local files) are readable and non-empty.

### Step 2 — Basic Rule Application (Deterministic)

1.  Scan the `rules/` directory for applicable rules.
2.  Read the YAML frontmatter of each rule to match `inputFields` with your prepared data.
3.  **Execute Checks:** Compare the content of your files against the "Incorrect/Correct" examples in the rule documentation.
4.  **Apply Logic:** Categorize findings into Pass/Fail.

### Step 3 — Specialized Script Execution (Heuristic & Complex)

For complex checks, execute the dedicated Python scripts in the `scripts/` directory:

| Task | Script Path |
|---|---|
| **Cloaking** | `scripts/cloaking_detection/cloaking_detection.py` |
| **Hidden Text** | `scripts/hidden_text_detection/hidden_text_detection.py` |
| **Keyword Stuffing** | `scripts/keyword_stuffing_detection/keyword_stuffing_detection.py` |
| **Sneaky Redirects** | `scripts/sneaky_redirect_detection/sneaky_redirect_detection.py` |
| **Favicon Audit** | `scripts/favicon_dimensions/favicon_dimensions.py` |
| **Experience Diversity**| `scripts/page_experience_diversity/page_experience_diversity.py` |

*Instructions for running each script are found in their respective README.md files.*

### Step 4 — Result Synthesis & Reporting

1.  **Normalize Results:** Translate pass/fail outputs from rules and JSON results from scripts into a unified report.
2.  **Prioritization:** Sort results by "Critical", "High", "Medium", and "Low" priorities.
3.  **Remediation:** For every failure, provide the specific "Actionable Fix" found in the rule documentation or script output.

---

## Example Invocations

### Example 1 — Website URL Audit
**User:** "Analyze https://example.com for SEO issues"
**Action:** Prepare inputs using `fetch_*.py` -> Apply Rules -> Run specialized scripts -> Generate prioritized report.

### Example 2 — Local File Audit
**User:** "Check @index.html and @robots.txt for SEO compliance"
**Action:** Validate files -> Apply matching rules from `rules/` -> Report findings.

### Example 3 — Spam Detection
**User:** "Check if this page is using hidden text or cloaking: @page.html"
**Action:** Run `cloaking_detection.py` and `hidden_text_detection.py` -> Report similarity scores and hidden elements.

---

## Troubleshooting

### Skill Undertriggering
- **Cause:** Vague request like "Check my site".
- **Fix:** Ask the user to provide a specific URL or upload files. Re-trigger with "I will now run an SEO audit on [URL]".

### Preparation Failures
- If `fetch_html.py` fails due to bot detection, advise the user that the site might be blocking headless browsers.
- If `fetch_robots_txt.py` returns 503, immediately flag the `ROBOTS_TXT_NOT_503` rule as Critical Fail.

---

## Trigger Testing Plan

### Should Trigger
- "Run an SEO audit on example.com"
- "Audit this HTML file for technical SEO"
- "Are there any spam policy violations on this page?"
- "Check my sitemap and robots.txt for errors"

### Should NOT Trigger
- "Write a blog post about SEO"
- "What is the keyword volume for 'cat toys'?"
- "How do I get more backlinks?"

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

seo-engine

Directory Structure

SKILL.md

Report

Notice