Index of every page on this site: llms.txt
All skills
Run it yourself

Find the exact words your audience already searches for and match each post to one searchable phrase plus its intent, with platform-native titles, captions, hashtags, and alt text — without invented keyword volumes or guaranteed-ranking claims. Use before drafting any post, when choosing a tutorial angle or Top 5 topic, and when reviewing a post after it publishes.

  • 4 files
  • 18 KB
  • Updated 5 days ago
  • GitHub
Use this Skill: https://skilld.dev/gh/jokerhtml/needcraft-skills/ai-seo-discovery

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

examplesper-post-seo-output.md

≈632 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Worked example: complete per-post SEO output

Status: example. The block below is a complete SEO output for an invented example post. The post was not published; the phrases were chosen from audience wording, not measured with a keyword tool, and no volumes are claimed. Copy the structure, replace every line with your own post's facts.

The post

A carousel teaching beginners to grow tomatoes on a balcony.

SEO output block

  • Primary search phrase: "grow tomatoes on a balcony"
  • Reader intent: do — the reader wants to grow them.
  • Secondary phrases (5):
    1. "balcony tomato growing"
    2. "growing tomatoes in pots"
    3. "tomato plants for small spaces"
    4. "when to plant tomatoes"
    5. "balcony vegetable garden"
  • Platform-native title/headline: "Grow Tomatoes on a Balcony (Even With No Garden)"
  • Caption/description (Instagram): "No garden? You can still grow tomatoes on a balcony — this carousel shows the pot, the soil, and the watering routine, step by step. No experience needed."
  • On-screen headline: "Tomatoes, on a balcony."
  • Opening spoken phrase (video version): "Here's how to grow tomatoes on a balcony — even with no garden."
  • Hashtags (2): #BalconyGarden #GrowYourOwn
  • Alt text: "Carousel slide showing a tomato plant in a pot on a balcony railing, with a watering can beside it."
  • Verified link destination: the growing guide the post is based on — check it on the day you publish and record the date here. No link is claimed until you have opened it.
  • Tie-break note: "growing tomatoes in pots" lost on specificity to the primary phrase; it becomes a secondary phrase and the subject of a later post.
  • Post-publication review note: at 24h check saves and profile visits; at 72h check Search Console queries for the primary phrase (own site only); at 7d compare against the previous tutorial post and record whether the primary phrase drove any search traffic. No ranking is promised.

Why this block passes the skill's rules

  • One primary phrase, with intent named.
  • Five secondaries, all genuinely relevant to the post.
  • No volume, difficulty, or ranking figure anywhere — the phrases are labelled as chosen from audience wording.
  • The keyword sits in the first line of the caption, in the on-screen headline, and in the opening spoken phrase.
  • The link destination is checked on the day of publishing and dated.
  • The tie-break loser is recorded with its reason, so the 7-day review has a ready-made next test.

Source: SKILL.md on GitHub

No rule matched.

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at 90f40b1. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 4 days ago.

Activeupdated 5 days ago
Other metadata
metadata
{
  "version": "1.0.0",
  "date": "2026-11-16",
  "author": "Muhammad Saad Ranjha / NeedCraft"
}

README badge

README badge for jokerhtml/needcraft-skills/ai-seo-discovery