hermes-agent/optional-skills/research/osint-investigation/templates/source-template.md

1. Summary

What this data source is, who publishes it, why it matters for investigations.

2. Access Methods

• API endpoint(s)
• Bulk download URLs
• Auth requirements (none / API key / OAuth)
• Rate limits

3. Data Schema

Key fields, record types, table relationships. List the columns the fetch script emits.

4. Coverage

• Jurisdiction
• Time range
• Update frequency
• Data volume (rows / GB)

5. Cross-Reference Potential

Which other sources can be joined and on what keys. Be explicit:

• <source> ↔ <column> (join key: <normalized entity name / EIN / CIK / etc.>)

6. Data Quality

Known issues — formatting inconsistencies, missing fields, duplicates, historical gaps, redaction.

7. Acquisition Script

Path: scripts/fetch_<source>.py

Example:

python3 SKILL_DIR/scripts/fetch_<source>.py --<filter> <value> --out data/<source>.csv

Output CSV columns: <col1>, <col2>, ...

8. Legal & Licensing

• Public records law / FOIA basis
• Terms of use / acceptable use
• Attribution requirements (if any)

9. References

• Official docs:
• Data dictionary:
• Related coverage / journalism: