Paragraph Counter

Overview

You pass text (or a file_ref); we split it on runs of blank lines, drop the empty blocks, and return how many paragraphs are left — plus the paragraph text itself when you ask for segments. You choose whether each block is trimmed. Do not use this for line, sentence, or word counting; the count skills for those units are separate.

Paragraph boundaries depend on formatting conventions. We make the rule explicit so you get auditable counts instead of guesswork.

When to use it

Scope

Non-goals

• Does not perform semantic paragraph detection
• Does not treat Markdown headings or HTML tags as paragraph breaks

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

File limits

Constraints this skill applies to your input and generated files. The “Limited by” column shows the static source of each cap; none of these can be raised by upgrading your plan.

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"text.count_paragraphs","input":{"text":"Para one.\n\nPara two.","policy":"blank_line_separated"}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("text.count_paragraphs", {"policy":"blank_line_separated","text":"Para 1\n\nPara 2"});

Errors

Other limits

Limitations

• Does not perform semantic paragraph detection
• Does not treat Markdown headings or HTML tags as paragraph breaks
• Semantic paragraph detection that requires NLP
• Structure analysis where headings or list items define logical sections

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "text.count_paragraphs",
  "input": {
    "policy": "blank_line_separated",
    "text": "Para 1\n\nPara 2"
  }
}

Examples

{
  "policy": "blank_line_separated",
  "text": "Para 1\n\nPara 2"
}

{
  "warnings": [],
  "unit": "paragraph",
  "policy": "blank_line_separated",
  "skill": "text.count_paragraphs",
  "count": 2
}

{
  "policy": "non_empty_line_blocks",
  "text": "Line one\nLine two\nLine three"
}

{
  "warnings": [],
  "unit": "paragraph",
  "policy": "non_empty_line_blocks",
  "skill": "text.count_paragraphs",
  "count": 1
}

Recommended use cases

• Measure document structure before summarization or chunking
• Validate that content meets paragraph-count guidelines
• Report formatting metrics alongside word or sentence counts

Avoid for

• Semantic paragraph detection that requires NLP
• Structure analysis where headings or list items define logical sections

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags