alterlab-tr-academic-style

$npx mdskill add AlterLab-IEU/AlterLab-Academic-Skills/alterlab-tr-academic-style

Formats manuscripts for Turkish journals with TR Dizin and APA-7 rules.

  • Ensures compliance with TR Dizin submission rules and Turkish APA-7 style.
  • Depends on alterlab-trdizin for live index status and alterlab-citation-mgmt for English styles.
  • Applies offline rules from TR Dizin criteria and Turkish APA-7 adaptation.
  • Outputs formatted text or flags conventions for user confirmation.

SKILL.md

.github/skills/alterlab-tr-academic-styleView on GitHub ↗
---
name: alterlab-tr-academic-style
description: "Formats manuscripts for Turkish journals: TR Dizin submission rules (TR Dizin mandates a set abstract word limit, two referees from different institutions, Latin script for non-Latin-alphabet articles, and only suggests a second-language abstract; bilingual oz/abstract ~200-250 words and 3-5 keywords are common journal house conventions to confirm against the journal's yazim kurallari) and the Turkish adaptation of APA-7 (ve ark./vd. for multi-author cites, ampersand only in the reference list, s. for page, Cev. for translator, t.y. for no date, aktaran for as-cited-in, Turkish capitalization). Use when writing for a Turkish/Turkce journal, preparing a TR Dizin submission, needing Turkce APA 7 in-text or reference formatting, or formatting a bilingual oz. For English-language citation styles prefer alterlab-citation-mgmt or alterlab-venue-templates; for live TR Dizin index status use alterlab-trdizin. Part of the AlterLab Academic Skills suite."
license: MIT
allowed-tools: Read Write Edit Bash(python:*)
compatibility: No API key or network required — applies the official TR Dizin evaluation criteria (and flags journal house conventions separately) plus the Turkish APA-7 adaptation offline; the linter in scripts/ runs on stdlib only
metadata:
  skill-author: AlterLab
  version: "1.0.0"
  last_updated: "2026-06-06"
  depends_on: "alterlab-trdizin (live index-status check), alterlab-citation-mgmt + alterlab-venue-templates (English citation styles)"
---

# Turkish APA-7 and TR Dizin Style

Applies Turkish academic-writing conventions to a manuscript: the **TR Dizin**
(TUBITAK ULAKBIM's national citation index — *Türkiye'nin ulusal atıf dizini*)
manuscript-formatting rules, and the **Türkçe APA 7** (the Turkish-language
adaptation of APA 7th edition) for in-text citations and the reference list.
This is the *style/formatting* skill for the Turkish track — it does not check
whether a journal is actually indexed (that is `alterlab-trdizin`), and it is
distinct from the English citation skills.

It exists because the suite's other writing skills (`alterlab-citation-mgmt`,
`alterlab-venue-templates`, `alterlab-paper-writer`) target English-language
APA/IEEE/Vancouver output. Turkish journals impose their own bilingual
**öz** (*abstract*) requirements and a citation dialect with Turkish
abbreviations (*ve ark.*, *vd.*, *s.*, *Çev.*, *t.y.*, *aktaran*) that those
skills do not produce.

## When to Use This Skill

Use this skill when the request is about **writing/formatting** a Turkish
manuscript or its citations:

- "Bu makaleyi TR Dizin formatına göre düzenle" — format a manuscript to TR Dizin rules.
- "Türkçe APA 7'ye göre kaynakça/atıf düzelt" — fix references / in-text cites to Turkish APA 7.
- Writing a bilingual **öz** + abstract pair (Turkish öz and Latin-script English abstract).
- Deciding whether to write *ve ark.* or *vd.*, where the *&* ampersand is allowed, how to write *s.*/*ss.*, *Çev.*, *t.y.*, or *aktaran*.
- Checking a Turkish journal manuscript against TR Dizin's structural requirements before submission.

### Does NOT Trigger

Route adjacent requests to the correct sibling skill:

| The user wants… | Route to |
|-----------------|----------|
| English-language APA/Vancouver/IEEE citations or a reference manager workflow | `alterlab-citation-mgmt` |
| A journal- or publisher-specific submission template (English venues) | `alterlab-venue-templates` |
| Whether a journal is **currently indexed** in TR Dizin (live status) | `alterlab-trdizin` |
| Find/harvest articles or metadata from a DergiPark-hosted journal | `alterlab-dergipark` |
| Search/cite a Turkish graduate thesis (YÖK Ulusal Tez Merkezi) | `alterlab-yok-tez` |
| Write or scaffold the whole paper (IMRaD, structure, drafting) | `alterlab-paper-writer` |
| Compute docentlik (*associate-professorship*) or akademik teşvik (*academic-incentive*) points | `alterlab-docentlik-eligibility` / `alterlab-akademik-tesvik` |
| Turkish etik kurul (*ethics-committee*) application or KVKK data plan | `alterlab-tr-research-ethics` / `alterlab-kvkk-dmp` |
| Verify that cited references actually exist (hallucination check) | `alterlab-citation-verifier` |

This skill owns **how Turkish text and citations are formatted**, not whether
the underlying journal/index/claim is real.

## TR Dizin manuscript requirements

TR Dizin is a **citation index with editorial criteria**, separate from
DergiPark hosting — hosting on DergiPark does not imply TR Dizin indexing.
**Distinguish two layers** and never present house conventions as index rules:

**What TR Dizin itself mandates** (from its official evaluation criteria):

- **A word limit for the abstract** must be set and enforced — TR Dizin
  specifies **no** number, and gives **no** keyword count.
- **Second-language metadata is *suggested*, not required.** TR Dizin only
  *suggests* a title/abstract/keywords in a language other than the article's.
  It *mandates* Latin script only for **non-Latin-alphabet articles** (their
  title/abstract/keywords/references), and requires the reference list in Latin
  script.
- **At least two referees per article, from different institutions**
  (*farklı kurumlardan hakem*); a manuscript should arrive review-ready.

**Common Turkish-journal house conventions** (widespread, but the *journal's*
rules — confirm against its *yazım kuralları*, do not attribute to TR Dizin):

- **Bilingual abstract:** a Turkish **öz** + an English **abstract**, each
  **~200-250 words** — a frequent default, not a TR Dizin figure.
- **Keywords:** **3-5** (*anahtar kelimeler*) per language — a frequent default.
- **Structured abstract** where the field requires it (e.g. health sciences):
  purpose, method, results, conclusion as labelled segments.
- **Latin Turkish letters with diacritics** in the metadata block (İ/ı, Ş/ş,
  Ğ/ğ, Ç/ç, Ö/ö, Ü/ü), not ASCII — so the record harvests cleanly.

Full criteria detail, the verbatim TR Dizin wording, and source links live in
`references/trdizin_manuscript.md`. For **live index status** ("is journal X
in TR Dizin right now?") do not guess — defer to `alterlab-trdizin`.

> Verify current TR Dizin criteria against the official page before a real
> submission — ULAKBIM revises them periodically. Source of record:
> https://trdizin.gov.tr/?p=456

## Türkçe APA 7 — the deltas from English APA 7

Turkish APA 7 keeps APA's structure but swaps the connective words and
abbreviations into Turkish. The high-frequency deltas:

| Situation | English APA 7 | Türkçe APA 7 |
|-----------|---------------|--------------|
| 3+ authors, in-text | Smith et al. | Yılmaz ve ark. **or** Yılmaz vd. |
| Two authors joined, **in-text (narrative)** | Smith and Jones | Yılmaz ve Demir |
| Two authors joined, **reference list / parenthetical** | Smith & Jones | Yılmaz & Demir (`&` only here) |
| Page / pages | p. / pp. | s. / ss. |
| No date | n.d. | t.y. (*tarih yok*) |
| Translator | Trans. | Çev. (*çeviren*) |
| Editor(s) | Ed./Eds. | Ed./Haz. (*hazırlayan*) |
| Secondary / as-cited-in | as cited in | aktaran |
| Retrieved from | Retrieved from | Erişim adresi |

Key rules:

1. **Ampersand `&` belongs only in the reference list and in *parenthetical*
   in-text citations.** In running Turkish prose use the word **ve**.
2. **`ve ark.` vs `vd.`** — both render "et al." Pick one and apply it
   consistently across the whole manuscript (a journal may mandate one).
3. **`aktaran`** marks a secondary citation (you read source B citing source
   A): `(Yılmaz, 2018, aktaran Demir, 2021)`.
4. **Turkish capitalization & diacritics** are preserved in titles and author
   names — never strip İ/ı, Ş/ş, Ğ/ğ, Ç/ç, Ö/ö, Ü/ü. Sentence-case article
   titles as in APA, using Turkish casing rules.

Worked in-text and reference-list examples (book, chapter, journal article,
thesis, translated work, secondary citation) are in
`references/turkce_apa7.md`.

## Workflow

1. **Identify the target.** Confirm the journal is Turkish/Türkçe and whether
   it follows TR Dizin rules and/or Türkçe APA 7. If the user actually needs an
   English venue template, stop and route to `alterlab-venue-templates`.
2. **Structure the metadata block.** Draft or check the öz/abstract and keywords.
   Propose the common house defaults (bilingual öz + abstract ~200-250 words
   each, 3-5 keywords each) but tell the user these are the *journal's*
   convention — TR Dizin itself only requires a word limit be set — so they must
   confirm the figures against the journal's *yazım kuralları*. Keep the
   metadata in proper Latin Turkish letters with diacritics. See the TR Dizin
   section.
3. **Convert citations.** Rewrite in-text citations and the reference list into
   Türkçe APA 7 using the delta table; preserve all diacritics.
4. **Lint.** Run the citation linter to catch the common mechanical errors
   (English abbreviations left in, `&` used in narrative prose, mixed
   `ve ark.`/`vd.`):

   ```bash
   uv run python skills/turkish-academia/alterlab-tr-academic-style/scripts/tr_apa_lint.py manuscript.md
   ```

   It reads a `.md`/`.txt`/`.tex` file (or stdin), reports line-numbered
   findings as text or `--json`, and is stdlib-only (no network, no deps).
5. **Report.** Present the corrected text plus the lint findings. Flag any
   point where a journal's own guide may override the default (e.g. it
   mandates `vd.` not `ve ark.`), and remind the user to confirm live TR Dizin
   status via `alterlab-trdizin` before submitting.

## Self-Check Before Reporting

- Did you present 200-250 words / 3-5 keywords / mandatory-bilingual as the journal's house convention (to confirm against its *yazım kuralları*), not as a TR Dizin index rule?
- Did you scope TR Dizin's own requirements correctly (word limit set; 2 referees from different institutions; second-language abstract *suggested*; Latin script mandated for non-Latin-alphabet articles)?
- Is `&` confined to the reference list and parenthetical cites (never narrative prose)?
- Is `ve ark.`/`vd.` consistent throughout?
- Are all Turkish diacritics intact in names and titles?
- Did you avoid asserting a journal's TR Dizin index status from memory? (That is `alterlab-trdizin`'s job.)

## References

- `references/trdizin_manuscript.md` — TR Dizin manuscript-formatting criteria, the DergiPark-vs-TR-Dizin distinction, and source links.
- `references/turkce_apa7.md` — full Türkçe APA 7 delta tables with worked in-text and reference-list examples.

Part of the AlterLab Academic Skills suite.

More from AlterLab-IEU/AlterLab-Academic-Skills

SkillDescription
alterlab-abm-mesaBuilds agent-based models of social systems with Mesa 3 — the current AgentSet API (model.agents.shuffle_do('step'), auto-assigned unique_id, mandatory super().__init__(seed=...)), cell spaces (mesa.discrete_space OrthogonalMooreGrid / classic mesa.space grids), the DataCollector, batch_run parameter sweeps, and SolaraViz — for emergence, segregation, diffusion, opinion dynamics, and cooperation models. It uses the Mesa 3.x API (the old mesa.time schedulers like RandomActivation are removed) and treats the model as a generative theory to be validated, not just run. Use when the request mentions an agent-based model, Mesa, simulating interacting agents, or emergent macro behavior from micro rules. For discrete-event (queueing/process) simulation prefer alterlab-simpy; for reinforcement learning prefer alterlab-stable-baselines3. Part of the AlterLab Academic Skills suite.
alterlab-academic-careerPrepares academic career documents and professional-development materials for faculty and researchers. Use when drafting academic CVs, research statements, teaching philosophies, diversity statements, faculty-position cover letters, tenure dossiers, promotion narratives, academic portfolios, or mentorship statements, and when planning conference-networking strategy, building academic web presence, setting up ORCID profiles, or understanding impact metrics. Part of the AlterLab Academic Skills suite.
alterlab-accreditation-aolScaffolds program-level Assurance-of-Learning (AoL) documentation for AACSB (2020 Standard 5) and ABET (Criterion 3 Student Outcomes, Criterion 4 Continuous Improvement) accreditation — program learning outcomes / competency goals, curriculum-to-outcome mapping matrices, direct- and indirect-assessment plans, rubric design, and closing-the-loop continuous-improvement narratives — and validates the structure of an outcome-mapping matrix with scripts/aol_matrix.py. Use when the user needs AACSB or ABET assurance-of-learning material, a program-learning-outcomes set, a curriculum/outcome map or coverage matrix, a direct/indirect assessment plan, a closing-the-loop report, or accreditation self-study text. For single-course design or course rubrics prefer alterlab-teaching-design; for post-award grant reports prefer alterlab-grant-reporting. Part of the AlterLab Academic Skills suite.
alterlab-adaptyvSubmits and tracks protein-testing experiments on the Adaptyv Bio Foundry cloud lab (wet-lab validation), and optimizes protein sequences before submission with computational tools (NetSolP, SoluProt, SolubleMPNN, ESM). Use when designing proteins that need wet-lab validation - binding/affinity screening, expression testing, thermostability, or fluorescence assays - or when submitting experiments to the Foundry API, browsing the target catalog, tracking experiment status, retrieving results, or pre-screening sequences for solubility/expression. Triggers on "Adaptyv", "Foundry API", "cloud lab", "biolayer interferometry / BLI", "wet-lab validation". Part of the AlterLab Academic Skills suite.
alterlab-aeonRuns time series machine learning with the aeon library — classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search via scikit-learn compatible APIs. Use when working with temporal data, sequential patterns, or time-indexed observations (univariate or multivariate) that need specialized algorithms beyond standard ML approaches. Part of the AlterLab Academic Skills suite.
alterlab-akademik-tesvikComputes the annual Turkish academic-incentive (akademik teşvik) score for Devlet (state) university öğretim elemanı (academic staff) from a classified activity list, applying the verified Akademik Teşvik Ödeneği Yönetmeliği (2018/11834) Faaliyet Hesaplama Tablosu headline puanları (Proje 20, Araştırma 15, Yayın 30, Patent 30, Atıf 30, Tebliğ 20, Ödül 20) with the k (author-count), p (Q1 1/Q2 0.8/Q3 0.5/Q4 0.25), and r (project-role) coefficients via türü puanı = Σ(faaliyet oranları) × headline (MADDE 8/2), then enforcing the per-type headline ceilings, the 100 cap (MADDE 8/3), and the net-30 payment gate (MADDE 10/3) in a deterministic scripts/tesvik_score.py. Use when the user wants to calculate akademik teşvik puanı, check the en az 30 (net-30) threshold, apply TABLO 4 ceilings, or estimate teşvik eligibility; keeps its coefficients separate from doçentlik scoring. For doçentlik point eligibility prefer alterlab-docentlik-eligibility. Part of the AlterLab Academic Skills suite.
alterlab-alpha-vantageAccesses real-time and historical stock market data, forex rates, cryptocurrency prices, commodities, economic indicators, and 50+ technical indicators via the Alpha Vantage API (requires a free API key from alphavantage.co). Use when fetching stock prices (OHLCV), company fundamentals (income statement, balance sheet, cash flow), earnings, options data, market news/sentiment, insider transactions, GDP, CPI, treasury yields, gold/silver/oil prices, Bitcoin/crypto prices, forex exchange rates, or calculating technical indicators (SMA, EMA, MACD, RSI, Bollinger Bands). Part of the AlterLab Academic Skills suite.
alterlab-alphafoldPredict protein 3D structures with AlphaFold2 via ColabFold — MMseqs2-accelerated MSAs, monomer and AlphaFold2-Multimer complex folding, and confidence-based validation (pLDDT, pTM/ipTM, PAE). Use when folding a protein sequence or complex from FASTA, generating a predicted structure with confidence metrics, ranking models, or checking self-consistency of a design. For co-folding a protein WITH a small-molecule ligand or predicting binding affinity prefer alterlab-boltz; for antibody–antigen or one-FASTA multi-entity complexes prefer alterlab-chai; to LOOK UP an already-computed structure prefer alterlab-alphafold-db; for ESM embeddings or inverse folding prefer alterlab-esm. Part of the AlterLab Academic Skills suite.
alterlab-alphafold-dbAccess the AlphaFold DB of 200M+ AI-PREDICTED protein structures — retrieve models by UniProt accession, download PDB/mmCIF files, and analyze prediction confidence metrics (pLDDT, PAE). Use when a UniProt ID needs a computationally predicted 3D structure or when no experimental structure exists, for homology modeling, protein engineering, or structure-based drug discovery; for EXPERIMENTALLY determined structures (X-ray, cryo-EM, NMR) prefer alterlab-pdb, and for protein sequences, annotations, or accession ID mapping prefer alterlab-uniprot instead. Part of the AlterLab Academic Skills suite.
alterlab-anndataBuild, slice, concatenate, read, and write AnnData annotated data matrices (obs, var, X, layers, obsm, uns) — the scverse data STRUCTURE, not an analysis pipeline. Use when creating or wrangling .h5ad/zarr files, managing cell and gene annotations, concatenating batches, or handling layers/obsm/backed-mode; for the QC, normalization, clustering, UMAP, and differential-expression analysis pipeline prefer alterlab-scanpy instead, and for RNA velocity from spliced/unspliced layers prefer alterlab-scvelo instead. Part of the AlterLab Academic Skills suite.